在Altium Designer中处理文档

上级页面：熟悉Altium设计环境

建立项目后，即可以在活动项目中添加、编辑或删除设计文档。由于Projects面板能够提供项目结构及其组成设计文档的组织视图，因此可以在该面板内完成上述操作。面板的右键单击上下文菜单提供了处理设计文档所需的大多数命令。

请注意，Projects面板上文档的显示方式并不反映其在硬盘驱动器或其他位置的存储方式。面板内容可以被视为项目的逻辑表示，而文档文件存储（及其类型）的物理位置和组织将由您决定——文档可能存储在本地计算机或LAN上的文件夹中，当然，也可能在由基本Git/SVN VCS系统或完全托管系统（例如，Altium Workspace）提供的版本控制存储库中进行托管。

添加或删除设计文档

向项目添加新设计文档的最简单方法是，右键单击Projects面板上的项目名称，然后从上下文菜单选项中选中Add New to Project。或者，从主菜单的Project » Add New to Project子菜单中选择所需文档类型，以将新文档添加到活动项目中。

将特定或其他类型的文档，添加到项目中。

其他类型的项目相关文档也可以添加到项目中，例如文本文件、PDF、电子表格等。为此，请使用Add Existing to Project选项（或活动文档编辑器主菜单中的Project » Add Existing to Project命令），并将Choose Document to Add browser对话框中的File Type下拉列表设置为All Files（*.*），以确保可以访问所有文件类型。

为了从项目结构中删除文档，请在Projects面板上右键单击其名称，然后选中Remove from Project菜单选项，或者在主菜单中选择Project » Exclude from Project命令。系统将提示您选择：

• Delete File – 永久删除源文档文件本身。

• Exclude from Project – 删除项目指向该文档的链接（而不是删除源文档文件本身）。如果其当前已在设计编辑器窗口中打开，则其将从其上级项目中删除，但仍作为离散文档在面板上保持打开状态。但如果其当前未在设计编辑器窗口中打开，则删除后将有效地将其关闭。

  

为了打开Windows Explorer的实例，请在存储项目文档的位置，在Projects面板上右键单击其入口，然后选中Explore命令。对于在Projects面板上关注的文档，可以通过单击面板顶部的控件完成上述操作。

打开文档

为了打开文档，请在Projects面板上双击该文档，或者右键单击其入口，然后在上下文菜单中选中Open命令。可以同时打开多个文档，并且每个打开的文档在设计窗口顶部的Documents Bar上均有自己的选项卡。

您还可以按照以下方式打开文档：

• 通过在编辑器主菜单中选择File » Open命令（Quick Access Bar上的按钮；快捷方式：Ctrl+O键）。以此方式打开的任何文档均将作为离散文档打开（显示在Projects面板Free Documents文件夹的相关子文件夹中），并在主设计窗口中成为活动文档。打开的任何项目文件均将添加到Projects面板上，并成为关注项目。 
• 通过右键单击所需类别的入口，然后在上下文菜单中选择Open All命令，可以打开Projects面板上关注类别（子文件夹）中的所有文档。
• 通过右键单击包含原理图文档的Source Document文件夹，然后在上下文菜单中选中Open All Schematic Documents命令，可以打开关注项目的所有原理图文档。

• 通过在主菜单中选择Project » Project Documents命令（快捷方式：Alt+Ctrl+O键），可以打开当前关注项目中或者活动设计项目组中所有已打开项目的一个或多个文档。

  启动命令后，将打开Open Project Documents对话框。使用此对话框选中您想要打开的文档。可以将视图限制为仅列出项目中当前在Projects面板上关注的文档，或者活动设计项目组中所有已打开项目的文档。使用标准Windows 快捷方式（Ctrl键+单击和Shift键+单击），从列表中选中多个项目。选中所需文档后，单击OK以将这些文档打开。

  
  The Open Project Documents dialog

  Click here to expand or collapse this section

  • Look in - 使用下拉列表选中所需项目所在的位置：Current Project或All Opened Projects。

  • List - 此为所选项目中所有文档的列表。单击所需文档，然后单击OK以将其打开。

    您也可以双击文档名称，以将其打开。
  • File name mask - 使用文本框输入字符或字符串，以筛选列表中的结果。
  • Files of kind - 使用下拉列表作为过滤器，然后选中想要在列表中显示的文件类型。
  • 所有所选文档均将在主设计窗口中作为选项卡式文档视图打开。最后所选文档将是最后一个打开的文档，而其上级项目将成为Projects面板上的活动项目（也是关注项目）。
  • 为了在Projects面板上显示文档的当前状态，请单击面板顶部的按钮，然后在弹出控件Sorting组中启用Open/modified status选项。或者，在Preferences对话框的System - Projects Panel页面上启用此选项。 

显示文档

打开文档与活动文档

当您打开文档时，其将成为活动文档。您可以在Altium Designer中，根据需要打开任意数量的文档，但只有一个文档可以成为‘活动’文档。活动文档在设计空间中打开，以确保您能够进行任何所需更新。当前活动文档的选项卡将以中灰色背景显示；已打开且当前未处于活动状态的文档将以炭灰色/黑色背景显示。

右键单击任何文档选项卡，以访问命令下拉列表，从而关闭右键单击的文档，关闭同一编辑器中与您右键单击文档相同的所有文档（例如，所有PcbDoc、所有SchLib或所有PcbLib文档），关闭所有打开的文档，分隔、平铺或合并文档。

为了使另一个打开的文档成为活动文档，请单击其选项卡。或者，使用Ctrl+Tab键或Ctrl+Shift+Tab键，根据所有已打开文档的最初打开顺序，分别向前或向后循环浏览这些文档。

还可以在主Window菜单底部的大多数编辑器中，找到当前已打开文档列表（文档按打开顺序列出）。通过此方式最多可以访问九个文档。使用命令，使所示已打开文档成为主设计窗口中的活动文档。

如果打开了大量文档，则可以选择通过启用Preferences对话框System - View页面上Documents Bar选项中的Group documents if need选项，对文档进行分组。可以按文档类型或项目，对文档进行分组。按文档类型分组的文档，将在分组选项卡中按字母顺序排序。按项目分组的文档，将在分组选项卡中的每个文档类型子组内按字母顺序排序。 

文档窗口管理

使用Altium Designer时，除了查看和使用单个设计文档外，还可以实现更多功能。其提供了各种命令，以确保您可以有效管理打开的文档，并根据您喜欢的工作习惯定制其显示。

右键单击文档选项卡，以访问用于管理文档的各种命令。这些命令包括影响主设计窗口中所有已打开文档显示的命令，如下所示。在执行跨文档任务（例如，在原理图与其PCB之间进行交叉探测）时，用于垂直（Split Vertical）或水平分隔（Split Horizontal）的命令非常有用。

分隔时，这些区域将被视为单个窗口。每个区域中可能有一个文档处于活动状态，但在任何给定时间，所有区域中仅有一个文档可以进行关注。添加新文档或打开现有文档时，该文档将作为当前关注文档所在区域的一部分打开。下图显示了垂直分隔的设计空间；高亮显示的原理图文档为当前活动文档。

还可以使用右键单击命令，将文档平铺（Tile All，快捷方式：Shift+F4键），以在设计空间中打开每个文档，如下图所示。图中，高亮显示的PCB文档为当前活动文档。

使用Merge All命令，将所有文档重新‘合并’到单个设计窗口中。

您也可以通过右键单击文档选项卡，然后从菜单中选择Open In New Window，或者单击其选项卡并将其拖动到当前Altium Designer窗口之外点位处，在单独设计窗口中打开文档。

Altium Designer窗口管理

当打开多个Altium Designer窗口时，您可以使用主菜单中的Window » Arrange All Windows Horizontally或Window » Arrange All Windows Vertically命令，分别水平或垂直排列桌面上的所有Altium Designer窗口，以确保其全部可见且不重叠。启动该命令后，桌面上存在且未最小化的所有Altium Designer窗口均将水平/垂直平铺，以确保您可以同时看到所有窗口。

文档导航

处理图形文档（例如，原理图、PCB文档或Draftsman文档）时，可以缩放和平移文档以关注特定文档区域。可用于执行此操作的基本快捷方式包括：

• 按Ctrl键+鼠标滚轮，以放大和缩小
• 右键单击，按住并拖动以滑动文档

View主菜单包含许多可用于控制当前文档视图的命令。

使用View主菜单的命令，控制文档视图。上图中，显示了原理图编辑器的视图菜单。下图中，显示了PCB编辑器的View菜单。

这些命令包括：

• Fit Document - 显示当前文档的整个区域。
• Fit All Objects - 显示当前文档上的所有设计对象。
• Area - 放大当前文档的用户自定义区域。
• Around Point - 重新定义当前文档中指定点的显示区域。
• Selected Objects - 更改设计空间中的视图，以确保所有选中对象均可见。
• Zoom In - 在当前文档中，使设计相对于光标位置更接近您。
• Zoom Out - 在当前文档中，使设计相对于光标位置远离您。
• Zoom Last - 将返回显示当前文档中屏幕的上一个视图。

跳转到文档中的特定点

您可以使用原理图、原理图符号、PCB或PCB封装编辑器主菜单中的Edit » Jump子菜单命令，跳转至活动文档中的特定点。还可以通过在设计空间中按J键，访问Jump弹出菜单。例如，您可以跳转至：

• 文档的原坐标：
  • 原理图的原点（对应于左下角）- Origin;
  • PCB文档的绝对原点 - Absolute Origin;
  • 当前PCB文档的相对原点 - Current Origin;
  • PCB封装文档中元件参考点的位置 - Reference;

• 当前文档中相对于用户指定XY坐标的任何位置——选中New Location命令，以在出现的Jump To Location对话框中，为设计空间内的X和Y坐标，输入光标预期跳转位置的值；

   
  Jump To Location对话框 - 在原理图编辑器（第一幅图）和PCB编辑器（第二幅图）中

• 文档中的对象。使用以下命令跳转至感兴趣的对象：

  • 原理图上的元件——Jump Component。启动该命令后，将出现Component Designator对话框。输入预期跳转元件的元件位号。如果位号有效，且元件位于活动项目的原理图源文档中，则相关原理图文档将成为活动文档，而目标元件将在主设计窗口中进行缩放和居中（如可能）。 已发现元件（或多部分元件的所有部分）也会列在Messages面板中。双击消息入口，以跳转到设计空间中的该元件（或其部分）。

    
    Component Designator 对话框

    定位多部件元件时，仅输入根位号。请勿包含部件后缀。例如，为了跳转至部件位号分别为位号IC1_CPA和IC1_CPB的2部件IC元件，请在Component Designator对话框中输入IC1_CP。对于多部件元件，将高亮显示第一部分，并打开Find Text - Jump对话框。使用此对话框，可在元件的子部分之间进行跳转。
    启用Component Designator对话框中的Physical选项，以将跳转特征限制为仅物理元件位号，即在编译项目后，出现在源原理图文档Compiled Document选项卡式视图上的元件位号。禁用此选项后，跳转功能将仅考虑逻辑位号——显示在源原理图文档Editor选项卡式视图上的位号。

  • PCB文档中的特定元件——Component。启动该命令后，将出现Component Designator对话框。输入元件位号以跳转至该元件。如果不确定位号，请输入？，然后单击OK以启动Components Placed对话框，其中列出了设计中的所有元件。光标将跳转至所选元件的参考点。

    在Component Designator对话框中输入？，以访问列出PCB中所有元件的Components Placed对话框。

  • PCB文档中的特定网络——Net。启动命令后，将出现Net Name对话框。输入您想要跳转到的网络名称，或者输入？，然后按OK以打开Nets Loaded对话框，其中包含设计中所有已加载网络的列表。在Mask字段中输入文本以搜索所需网络。输入时，将筛选列表以仅显示与Mask字符串相匹配的字符串。您可以使用Mask字符串中的通配符？（任何单一字符）和*（任何字符）。如果目标Net已显示在主设计窗口中，则光标将跳转到作为该Net成员的最近设计对象。如果未显示Net，则光标将跳转到作为该Net成员且在设计空间内居中（如果可能）的最近设计对象上。

    在Net Name对话框中输入？，以访问列出PCB中所有网络的Nets Loaded对话框。

  • PCB文档中的特定元件焊盘——Pad。启动命令后，将出现Jump To Pad Number对话框。以ComponentDesignator-PadDesignator（例如，U1-6）形式，输入所需元件的所需焊盘，然后单击OK。如果目标焊盘已显示在设计空间内，则光标将跳转到该焊盘的中心。如果未显示焊盘，则光标将跳转到设计空间内居中（如果可能）的焊盘中心。

    Jump To Pad Number对话框

  • PCB文档中的特定字符串——String。启动命令后，将出现Jump To String对话框。输入想要跳转到的字符串，或者输入？，然后单击OK以打开Strings对话框，其中包含在活动板文档中所有已发现字符串的列表（离散文档和其他组对象的子文档）。使用此对话框可以快速找到想要跳转到的字符串。如果目标字符串已显示在设计空间中，则光标将跳转到字符串的定位点——即在移动操作期间保持该字符串或旋转中心所在点。如果未显示字符串，则光标将跳转到设计空间内居中（如果可能）的字符串定位点。

    在 Jump To String 对话框中输入？，以访问列出 PCB 中所有网络的 Strings 对话框。

    系统将执行三次搜索：首先搜索大小写、字符和长度均与指定字符串匹配的字符串；然后搜索含有相同字符但可能具有更多字符的字符串；最后搜索具有相同字符（忽略大小写）的字符串。

  • 跳转至当前设计文档中的所有错误标记并循环浏览——Error Marker。启动该命令后，光标将跳转至位于主设计窗口中心的第一个Design Rule Check（DRC）错误标记。重复使用该命令将跳转至第二个错误标记，依此类推。此命令将跳转至错误标记（无论是否放弃违规）。

    通过右键单击并从Violations子菜单中选择相关命令，在光标下查询与对象关联的冲突。

• 跳转至当前文档中的所有所选设计对象并循环显示——Selection。启动该命令后，光标将跳转至第一个选中对象，并且在主设计窗口中缩放和居中。重复使用该命令将跳转至第二个选中对象，依此类推，循环显示当前文档中的所有选中对象。该命令将按照所选对象最初添加到所选内容的顺序，循环显示所选对象。

• 当前原理图或PCB文档中的位置，其坐标之前已存储在所示位置标记中——选中Location Marks » n命令，以使用Set Location Marks »命令跳转至已存储在指示位置标记中的位置。

  对于原理图文档，存储位置仅在文档保持打开状态（活动或不活动）时可用。如果文档在关闭后再次打开，则位置标记将为空。对于PCB文档，位置标记将与设计一同保存，因此在设计会话之间仍然可以访问其中包含的用户自定义位置。

指示文档状态

在Altium Designer中处理项目文档时，Projects面板将通过与每个设计文档关联的状态图标和主项目文档提供经修改或保存文档文件的可视化摘要。这提供了一个快速可视化摘要，说明哪些文件被修改、保存，其位于Workspace还是本地，及其版本控制状态。文档图标和含义如下：

打开/修改状态图标

[blank]	文档已关闭。
	Open – 文档在设计编辑器窗口中作为选项卡式文档打开。
	Open/Modified – 文档已打开且已修改（尚未保存）。 在Projects面板上，经修改文档在其入口旁边用星号后缀标记。经修改文档在其已打开文档选项卡中名称旁边还有一个星号（如果文档已分组，则在关联弹出菜单上）。
	文档文件打开后，将被Altium Designer的该实例锁定。
	文档文件打开后，已被Altium Designer的另一个实例锁定。
	其他用户正在编辑文档。
	其他用户正在编辑的文档，当前在编辑器中处于打开状态。
	文档丢失（详细了解丢失文档）。

版本控制状态图标

版本控制系统实质上是监视工作文件夹中的文件并将其与设计存储库中的对应文件进行比较。Altium Designer通过其VCS接口向版本控制系统发送请求和交换信息，并根据具体情况响应比较文件状态条件。实际上，其体现在Projects文件图标、一系列VCS警报以及对可用文件管理命令的适当更改中。

图标及其含义如下：

[blank]	N/A	文件不在VCS存储库的版本控制之下。
	无需修改	文件的本地副本与存储库中的文件匹配，且为最新版。
	计划添加	文件已添加到版本控制中，但尚未提交（签入）至VCS存储库。
	已修改	文件的本地副本已被修改并保存到工作文件夹中。提交文件，以在存储库中创建新版本。
	已过时	文件的本地副本（在工作文件夹中）比存储库中的对应副本旧，因此已过期。使用Projects面板History & Version Control右键菜单中的Update或Update Whole Project命令，或者使用Projects » History & Version Control主菜单从存储库中检索最新文件或保存文件，这将产生冲突状况。
	冲突	在您提交自己编辑和保存的文件版本之前，该文件已由其他用户提交。使用Version Control Update或Resolve命令，确定哪个文件版本将成为存储库中的最新版本。
	领先于服务器（Git）	本地工作存储库中的文件比远程Git存储库中的对应文件更新。当本地文件已被修改、保存并提交到本地存储库，但尚未推送到远程存储库时，可能会发生此情况。
	计划删除	项目文件已从版本控制中删除，并将在Version Control Commit过程中从VCS存储库和数据库中删除。当本地工作文件夹中丢失文件（该文件已被删除、重命名或移动）时，也会显示此图标，此问题可以通过使用History & Version Control » Update命令，从存储库重新填充文件夹解决。

保存文档

可以通过以下方式在本地保存当前活动文档：

• 在主菜单中，选择File » Save命令。
• 单击Quick Access Bar上的按钮。
• 单击编辑器主工具栏上的按钮。
• 使用键盘快捷键Ctrl+S。

（如果文档实际处于打开状态）也可以通过右键单击其在面板上的入口并在上下文菜单中选择Save命令，以保存Projects面板上当前关注的文档。

可以通过单击Projects面板顶部的按钮，保存Projects面板上当前关注的项目（文档、项目或项目组）。当关注条目为项目时，仅保存项目文档。此命令不保存组成设计文档。当关注条目为设计项目组时，仅保存设计Project Group文档（*.DsnWrk）。此命令不保存组成项目及其设计文档。 

还可以使用其文档选项卡中的相应命令，保存处于修改状态的文档——右键单击选项卡，以访问命令的上下文菜单。请注意，如果打开了多个相同类型的文档且当前已分组，则此命令将不可用。

打开的项目文档可以使用Projects面板上文档入口处右键菜单中的File » Save As命令或Save As命令，以新名称保存，从而以指定的新名称创建文档文件副本。此过程会自动将新文档副本添加（链接）到活动项目，以替代源文件夹中保持不变的现有（源）文档。如果打开的文档不是项目（离散文档）的一部分，则仅需在编辑器中打开新副本即可替代原始文档。

启动该命令后，将显示标准Windows Save As对话框。使用此对话框可以浏览到需要在其中保存文件的特定目标，为文件指定新名称（必要时），以及选择文件存储格式（如果可用）。新保存文件将作为活动文档，替代原始文件打开。

如果只是制作文档的备份副本，请使用Save Copy As选项。此操作将创建文档文件的命名副本，而不会影响其宿主项目。启动该命令后，将显示标准Windows Save A Copy Of对话框。使用此对话框可以浏览到需要在其中保存文件的特定目标，为文件指定新名称（必要时），以及选择文件存储格式（如果可用）。新保存的文件将不会替代原始文件打开。

所有已修改项目和文档均可通过以下方式保存：

• 从编辑器主菜单中，选择File » Save All命令。
• 单击Quick Access Bar上的按钮。
• 在Projects面板上，右键单击设计项目组的入口，然后在上下文菜单中选择Save All命令。

如果项目是现有（之前保存的）Project Group的一部分，并且项目成员身份已更改（自上次保存以来添加或删除的项目），则Project Group文档（*.DsnWrk）也将被保存。

为了保存Projects面板上关注类别（子文件夹）或其子文件夹内当前打开的所有文档，请右键单击所需类别（子文件夹）的入口，然后在上下文菜单中选择Save All命令。

管理项目文档

更改项目文档顺序

Projects面板上的文档会自动排列在逻辑组或‘文件夹’中（例如，Schematic、PCB等源文档，Harness、Outjob等设置文档），且如果是层次式设计，则为顶级原理图文档。默认情况下，每个文件夹组中的文档均将按添加顺序显示，但可以拖放到组中的新顺序位置。

对于新层次式设计，文档之间的主从关系将显示在Projects面板上。请注意，连通关系无法通过拖放原理图文档进行定义，因为图纸间连接和设计层次结构实际上将通过图纸符号和端口定义进行定义。

► 如需了解关于项目层次结构的更多信息，请参阅Project Options对话框Options选项卡中的Creating Connectivity 和 Net Identifier Scope部分。

文档重命名

您可以通过Projects面板右键单击上下文菜单使用Rename命令，以直接更改任何PCB项目组成设计文件的名称（*.PcbDoc、*.SchDoc等），PCB项目本身（*.PrjPcb）或项目组（*.DsnWrk）。

在Altium Designer中进行项目本地重命名及其设计文件示例。当您保存更改并将其发送到该Workspace时，这些更改将与Workspace同步。

执行重命名后，使用Save to Server命令（可通过项目的同一上下文菜单获取）将更改保存到Workspace。在项目的本地工作副本与其在Workspace中的对应副本之间，将同步进行文件重命名。此外，当重命名项目文件名并将项目保存到服务器时，Workspace会自动更改托管项目的Name参数以进行匹配。

反之，当通过Workspace的浏览器界面更新托管项目的名称时，此更改将在下次打开项目时传递至Altium Designer。

在Altium Designer（File » Open Project）中打开更新后的项目时，初始对话框将提供将本地项目文件名与新项目名称保持一致的选项，或强制服务器项目名称与现有项目文件名匹配。

在Workspace侧重命名项目时，可用的选项。

在项目之间共享文档

由于Altium Designer项目定义并保存了指向存储文档文件的链接，因此可以创建任意数量的项目，以链接至这些相同的文档文件。

尽管这样操作可能便于复用已建立的设计文档（例如，在多个项目中包括标准电源原理图），但不建议这样做，因为对文档进行更改可能影响其链接的所有项目。为了更好地进行设计复用，应建立和应用Managed Sheets。

► 如需了解关于设计文档复用和Managed Sheets的更多信息，请参阅Managed Sheets 页面。

丢失文档的管理

如果在项目文件夹中找不到在项目文件中定义的项目文档（例如，已从Windows Explorer中删除该文档），则认为该文档丢失。打开包含丢失文件的项目时，Messages面板上将显示相应的通知。文档入口将灰显，并在Projects面板上用一个可区分的图标将其标记为丢失。

可以使用关联命令，全面掌控丢失文档的处理。使用Projects面板上丢失文档的右键菜单，从项目中删除选中文件或所有丢失文件，或者更新文件路径（即，用选中文件替换丢失文件）。对于受版本控制的项目，您还可以恢复本地修改，以从项目的VCS存储库中恢复丢失文件。

使用项目入口右键菜单中的Add Existing to Project命令，将现有文件添加到项目，并且被添加文件的名称和路径与丢失文件的名称和路径相同时（例如，在Altium Designer中打开项目后将丢失文件添加到项目文件夹中时），将打开一个确认对话框，以询问您是否要用选中文件替换丢失文件。

将本地文档与提交或发布数据进行比较

选中Latest Commit或Latest Release命令后，将开始与最新提交/发布入口中的项目数据进行比较。选中Select Commit或Release命令后，将打开所选项目的Project History视图。选中提交或发布标题，将本地保存的数据与此提交/发布的数据进行比较。

完成后，比较结果将显示在Compare视图中，该视图将在默认浏览器中作为新选项卡打开。

Clipboard面板

为了存储和显示可在任何阶段添加（粘贴）到Altium Designer文档中的复制对象，以进行多次复制/粘贴操作，我们可以使用Clipboard面板。

查看和应用（粘贴）所有设计数据类型的Clipboard面板内容。