管理项目文档

项目面板

面板 Projects面板显示当前打开的所有项目及其组成文档和结构。面板的右键上下文菜单提供了处理设计文档所需的大部分命令。

面板 Projects面板

请注意，面板中文档的显示方式 Projects面板中的文档显示并不反映它们在硬盘或其他地方的存储情况。面板的内容可以被视为项目的逻辑表示，而文档文件存储的物理位置和组织（及其类型）则由你自己决定--文档可能存储在本地计算机或局域网的文件夹中，当然也可能托管在由基本 Git/SVN VCS 系统或全面管理系统（如 Workspace）提供的版本控制存储库中。

面板的行为 Projects面板的行为可通过系统 - 项目面板对话框的 Preferences对话框的系统-项目面板页面上的选项配置面板行为。也可以使用面板顶部的 控件访问这些选项。

连接到工作区时，工作区图标 (/) 将显示在该工作区最上方条目的旁边。打开项目的本地工作副本，但未连接项目所在的工作区时，将显示灰色的工作区图标 (/)。

也可以与您共享工作区项目，而不邀请您加入该项目所在工作区的团队。通过共享访问打开的项目会显示一个相关的 Shared with me标签，旁边带有图标。

如果项目已与您共享，您只能查看该项目，则该标签将显示在项目旁边。 View Only标签将显示在面板中的项目条目旁边，以表明这一点--举例说明。

本地项目列在项目组( ) 的条目下。 *.DsnWrk) 下列出--可以是默认组 (Project Group 1.DsnWrk) 或您创建或打开的项目。

要访问当前连接的工作区的上下文菜单，请右键单击工作区名称或单击其最右侧的 控件。这些命令包括

• Open Project- 打开 "打开项目 "对话框。
• Create Project- 打开创建项目对话框。
• Show in Explorer- 打开资源管理器面板。
• Show in Web Browser- 打开 Projects工作区浏览器界面的页面。
• Sign out- 退出工作区。
• Sign in- 登录到工作区。如果您在 "项目 "面板中至少打开了一个工作区项目（如项目），且当前与该项目所在的工作区断开连接，则可以使用此命令。

您必须连接到工作区才能访问这些命令。退出工作区后，右键单击要连接的工作区，然后单击 Sign In命令。

项目文档树

打开现有项目或创建新项目时，其条目将出现在 Projects面板。作为项目一部分的任何现有文档（以及任何已添加的新文档）将根据其用途和/或类型显示在子文件夹下。例如，项目下可以出现以下常用文件夹和内容文档类型：

• Source Documents- 核心设计文档，如原理图、印刷电路板等。
• Settings- 提供项目中使用的各种文件，包括输出工作文件、线束定义文件和注释文件等相关文件。
• Libraries- 本地源代码库文件。文件根据库类型（如原理图库、PCB 库等）进一步细分。
• Documentation- 已添加到项目中的附加文档，类型为 Altium Designer 已知（如文本、PDF 等）。
• Other Documents- 添加到项目中的 Altium Designer 未知类型的附加文档。如果所有者应用程序为 Windows 所知，Altium Designer 可以打开这些文件（如 Word 文档、Excel 电子表格等）。
• Generated- 作为输出生成的文档。文档根据类型进一步细分（如 BOM 文档、文本文档等）。随着项目输出的生成，主树中相应的子文件夹也会随之创建和填充。
• Components- 该文件夹列出了每个组件以及每组中组件的数量。如果该文件夹未出现 (Project » Validate).默认情况下，组件按代号中的第一个字母分组--右键单击组件条目（或组件分组文件夹）并从右键菜单中选择 Component Grouping命令，以快速访问 Components Grouping控制 Projects面板的控制，并根据需要更改分组样式或禁用分组。如需了解更多信息，请参阅 "在原理图中创建电路连接"页面的 "在项目结构中搜索元件和网络"部分。
• Nets- 此文件夹列出了项目中使用的每个网络。如果该文件夹未出现（ ），请验证项目。Project » Validate).有关更多信息，请参阅 "在原理图中创建电路连接"页面的 "在项目结构中搜索元件和网络"部分。

Notes on working in the documents tree:

• 任何独立于项目的文件都将显示为 Free Documents并显示在相应的子文件夹下。右键单击空闲文档并从右键菜单中选择 Add to Project 命令，就可以将当前打开的自由文档添加到活动项目中。或者，也可以将其拖放到所需项目名称的 Projects面板。
• 除了允许打开多个文档进行编辑外，该环境还支持同时打开多个项目。这些项目可以是相关的，也可以是不相关的。
• 面板中的文件 Projects面板中的文档会自动按逻辑组或 "文件夹 "排列，如源文件（原理图、印刷电路板等）、设置文件（线束、输出工作等），如果是分层设计，还包括顶层原理图文件。默认情况下，每个文件夹组内的文档按添加顺序显示，但也可以拖放到组内新的顺序位置。
• 如果是新的分层设计，面板中将显示文档之间的父子关系。请注意，连接关系不能通过拖放原理图文档来定义，因为表间连接和设计层次实际上是由表符号和端口定义的。
• 右键单击项目文档子文件夹（无论是展开的还是关闭的），可访问其他文档管理命令，如打开、关闭或保存重点项目文档子文件夹中的所有文档。
• 通过单击和拖动，可以在面板中的项目之间传输文档。文档不必拖入正确的子文件夹，它会自动正确地放置在项目结构中。
• 键盘快捷键 Up Arrow, Home, End和 Down Arrow可分别用于显示面板中的上一个、第一个、最后一个和下一个条目。使用 Right Arrow和 Left Arrow键分别展开和折叠顶层条目或其子文件夹。
• 要从面板中选定的元件或网络条目交叉探测到上一级 PCB 设计项目原理图或 PCB 文档中的实体，请右键单击条目并选择 Projects面板中的选定元件或网项交叉探测到上一级 PCB 设计项目原理图或 PCB 文档中的实体，可右键单击该条目并选择 Cross Probe to Schematic或 Cross Probe to PCB命令。
• 要在存储项目文档的位置打开 Windows 资源管理器实例，请右键单击其在 Projects面板中的条目，然后选择 Explore命令。对于在 Projects面板中的文档，可通过单击面板顶部的 控件来打开。

项目选项

现有的或新创建的项目都与一系列选项设置相关联，这些选项设置是该项目特有的。这些设置存储在项目文件 (*.PrjPcb为例），并根据项目类型而有所不同。

选项设置在 "项目选项 "对话框中配置，可以从主菜单的 Project » Project Options或右键单击面板中的项目名称，然后选择 Projects面板上右击项目名称，然后从右键菜单中选择 Project Options即可进入该对话框。对于在 Projects面板中的项目，可通过点击面板顶部的 控件进入对话框。

在其他对话框中定义并存储在项目文件中的其他项目设置包括

• 原理图注释设置。
• 输出设置，如报告、打印、Gerber 等。请注意，这些是通过原理图或 PCB 编辑器菜单访问的输出设置，而不是在OutJob 文档中定义的输出设置。

显示文档状态

当您在 Altium Designer 中处理项目文档时，面板上的 Projects面板通过与每个设计文档和主项目文件相关联的状态图标，提供文档文件修改或保存的可视化摘要。这样就可以快速直观地了解哪些文档被修改、保存，它们是工作区文档还是本地文档，以及它们的版本控制状态。文档图标和含义如下。

打开/修改状态图标

空白	文档已关闭。
	打开 - 文档在设计编辑器窗口中作为标签页文档打开。
	打开/已修改 - 文档已打开并已修改（尚未保存）。 修改后的文档会在其条目旁以星号后缀标记。 Projects 面板。修改过的文档在其打开的文档选项卡（如果文档已分组，则在相关弹出菜单上）中的名称旁边也有一个星号。
	文档文件已打开并被 Altium Designer 锁定。
	文档文件已打开并被 Altium Designer 的另一个实例锁定。
	文档正在被其他用户编辑。此状态条件由协作者可视化和冲突预防功能启用。
	其他用户正在编辑的文档当前在编辑器中打开。此状态条件由Collaborators 可视化和冲突预防功能启用。
	文档丢失（了解有关丢失文档的更多信息）。

版本控制状态图标

版本控制系统主要是监控和比较工作文件夹中的文档文件和设计资源库中的对应文件。Altium Designer 通过其 VCS 接口与版本控制系统请求和交换信息，并对比较文件状态条件做出相应的响应。在实践中，这体现在 Projects文件图标，通过一系列 VCS 警报，并通过对可用文件管理命令的适当更改来实现。

图标及其含义如下：

空白	不适用	文件不在 VCS 版本库的版本控制之下。
	未修改	文件的本地副本与版本库中的文件一致，并且是最新的。
	计划添加	文档已添加到版本控制中，但尚未提交（签入）到 VCS 版本库。
	已修改	文档的本地副本已被修改并保存到工作文件夹。提交文档可在版本库中创建新版本。对于 PCB 文档，您还可以使用PCB CoDesign功能将本地修改与工作区中的最新提交进行比较。 Local Changes to Remote Document Version命令，将本地修改与工作区中的最新提交进行比较。 History & Version Control » Compare To右键菜单中的 Projects面板或 Projects » History & Version Control » Compare To主菜单。
	过时	文件的本地副本（在工作文件夹中）比资源库中的对应文件旧，因此已过期。使用 Update Project From Server命令。 History & Version Control右键菜单中的 Projects面板右键菜单或 Projects » History & Version Control主菜单中的命令，从工作区中获取最新的文档。请注意，在这种状态下保存文档会产生冲突条件。 当项目只包含过期和未修改状态的文档时，您也可以使用 Update from Server控件，该控件会出现在 Projects面板中项目名称旁边的控件，从工作区中检索过时文档的最新文档 - 显示图像。
	防止冲突	在你提交自己编辑并本地保存的文档版本之前，另一个用户已经提交了该文档。使用版本控制 Revert Local Changes命令放弃对项目文档的本地修改。对于 PCB 文档，还可以使用PCB 协同设计功能来比较和合并更改。
	检测到冲突	当尝试将项目保存到工作区时，如果项目包含的文档处于 Conflict Prevention状态的文档时，这些文档将处于 Conflict Detected状态。将显示 Action Required信息对话框，列出需要解决的冲突文档。从 History & Version Control » Resolve Conflict右键单击 Projects面板的右键菜单中使用以下命令来解决冲突： Compare To Remote Version & Merge- 使用此命令可通过使用 PCB协同设计功能比较和合并更改来解决 PCB 文档的冲突。 Use Remote Version- 使用该命令可使用工作区的最新版本更新文档，从而解决冲突。 Keep Local Version- 使用此命令可通过使用文档的本地版本来解决冲突。
	领先于服务器（Git）	本地工作仓库中的文档比远程 Git 仓库中的文档更新。当本地文档已被修改、保存并提交到本地版本库，但尚未提交到远程版本库时，就会出现这种情况。 Pushed提交到远程版本库。
	计划删除	项目文档已从版本控制中删除，并将在版本控制提交过程中从 VCS 版本库和数据库中删除。当本地工作文件夹中的文档丢失（已被删除、重命名或移动）时，也会出现此图标。 Restore document from VCS命令从版本库中重新填充文件夹。
	合并	使用 PCB协同设计功能，将 PCB 文档与版本库中较新的修订版合并。将项目提交到工作区，将合并后的 PCB 文档保存到工作区的资源库中。

更改项目文档顺序

面板中的文档 Projects面板中的文档会自动按逻辑组或 "文件夹 "排列，例如源文档（原理图、PCB 等）、设置文档（线束、输出工作等），如果是分层设计，则是顶层原理图文档。默认情况下，每个文件夹组内的文档按添加顺序显示，但也可以拖放到组内新的顺序位置。

如果是新的分层设计，文件之间的父子关系将显示在 Projects 面板中显示。请注意，连接关系不能通过拖放原理图文档来定义，因为表间连接和设计层次实际上是由表符号和端口定义的。

► 有关项目层次结构的更多信息，请参阅创建连接性和 "选项 "选项卡中的 "连接性"部分。 Net Identifier Scope部分。 Project Options对话框选项卡中的部分。

文档重命名

您可以直接更改任何 PCB 项目组成设计文档的名称 (*.PcbDoc, *.SchDoc等）、PCB 项目本身 (*.PrjPcb) 或项目组 (*.DsnWrk) Rename命令（可从右键单击项目面板上的项目上下文菜单中获取）以及随后的 Rename对话框。

从 Altium Designer 本地重命名项目及其设计文档的示例。当您保存并向工作区发送更改时，这些更改将与工作区同步。

执行重命名后，使用 Save to Server命令（可从项目的同一上下文菜单中使用）将更改保存到工作区。项目的本地工作副本和工作区中的对应文件将保持文件重命名同步。此外，当项目文件名被重命名并保存到服务器时，工作区会自动更改受管项目的名称参数，使之与之匹配。

反之，当通过工作区的浏览器界面更新受管项目的名称时，下一次打开该项目时，更改会传播到 Altium Designer。

要编辑工作区中现有托管项目的属性，请在 Projects页面上选择其条目，单击项目列表上方的 控件，然后在相关菜单中选择 Edit 条目。在随后出现的 Edit Project窗口中更改项目名称。

在 Altium Designer (File » Open Project) 中打开更新后的项目时，初始对话框会提供一个选项，使本地项目文件名与新项目名一致，或强制服务器项目名与现有项目文件名一致。

如果在工作区侧重命名了项目，则选项可用。

在项目间共享文件

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

虽然这可能是重新使用已建立的设计文档的一种便捷方法，例如，在多个项目中包含一个标准电源原理图，但这并不是推荐的做法，因为文档的更改会影响其所链接的所有项目。更好的设计重用方法是建立和应用 Managed Sheets.

有关设计文档重用和托管示意图表的更多信息，请参阅 "使用托管示意图表"页面。

管理丢失的文档

如果项目文件中定义的项目文档在项目文件夹中找不到（例如，文档已从 Windows 资源管理 器中删除），则视为丢失。打开包含丢失文件的项目时，相应的通知将显示在 Messages面板中显示相应的通知。文件条目将显示为灰色，并在 Projects面板。

可使用相关命令来全面控制丢失文件的处理。使用右键单击面板中丢失文档的 Projects面板上的右键菜单，从项目中删除选定的或所有丢失的文件，或更新文件路径（即用选定的文件替换丢失的文件）。对于版本控制下的项目，还可以还原本地修改，从项目的 VCS 资源库中恢复丢失的文件。

向项目添加现有文件时，可使用项目条目右侧的 Add Existing to Project命令将现有文件添加到项目时，如果添加文件的名称和路径与缺失文件的名称和路径相同（例如，缺失文件是在 Altium Designer 中打开项目后添加到项目文件夹中的），则会打开一个确认对话框，询问是否要用所选文件替换缺失文件。

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

对于工作区托管的项目，您可以将本地保存的原理图、PCB 和 BOM 文档与该项目提交或发布的数据进行比较。可从以下位置选择用于比较本地文档的所需数据集的命令：

• 在 History & Version Control » Compare To项目面板中项目文档的右键菜单。
• 保存到服务器对话框中的 Compare按钮菜单。
• 控制菜单。 Local Changes的控制菜单。

❯ ❮ JavascriptID：LocalCompare_AD24

• 当 Latest Commit或 Latest Release命令时，将开始与最新提交/发布条目中的项目数据进行比较。
• 当 Select Document Version or Release命令（从 Projects面板）或 Select Commit or Release命令（从 Save to Server对话框）时， Document History或 Project History视图将分别为所选文档/项目打开。选择提交或发布的磁贴，可将本地保存的数据与该提交/发布的数据进行比较。

完成比较后，比较结果将显示在 "比较 "视图中，并在默认浏览器中以新标签页的形式打开。

剪贴板面板

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

查看和应用（粘贴） Clipboard 面板内容。