您可以使用“版本和历史记录”面板来创建版本(仅限查看),并分支版本以创建新的工作区。您还可以比较工作区和版本中的历史记录条目,以及两者的任意组合。有关更多信息,请参阅比较。


您可以从文档面板创建版本;单击 可创建新版本且不离开该工作区。
您还可以通过“版本和历史记录”(也位于“文档”面板中)创建版本:
- 在文档打开的情况下,单击
以打开“版本和历史记录”。
- 单击要从其创建版本的工作区,这样将激活该工作区。
- 单击“创建版本”图标
。
- 在出现的对话框中,输入新版本的名称和说明。
- 如果文档中的任何工程图具有待决的更新(由亮黄色的“更新”图标
指示),则对话框中将包含一条消息:
单击消息中的图标
以更新列出的所有工程图,以使版本包含最新版本的工程图。请注意,如果您单击“更新”图标而后取消对话框,仍会更新工程图。
- 单击任意一项:
- 创建 - 创建新版本且仍在当前活动的工作区中
- 创建版本并编辑属性 - 创建新版本并打开新版本的“属性”对话框。此“属性”对话框包括新版本中每个选项卡和零件的名称和说明。
新版本会显示在版本和历史记录图表中:
当更新文档参考时,Onshape 还可能会自动创建版本。在此情况下,您将在图形中看到自动版本图标,如下所示:
如果用户是 OnShape 员工,则图表中“已修改”列下方用户名左侧会显示 Onshape 徽标图标:
有关自动版本控制的更多信息,请参阅 更新参考文献。

如果用户拥有该文档,则可以删除工作区。
如果与用户共享文档,并且在该文档的共享权限设置下启用了“删除”,则该用户可以删除该文档的工作区。
删除文档的工作区会从分支的尖端(末端)删除工作区:
-
如果分支上不存在任何版本,则会删除工作区和分支。
-
如果分支包含一个或多个版本,则该工作区将被删除,分支将恢复为最新版本。
若要删除工作区,请执行以下操作:
- 在文档打开的情况下,单击
以打开“版本和历史记录”。
- 右键单击要删除的分支。
- 选择“删除”。
- 单击“删除”进行确认。

若要还原已删除的工作区,请执行以下操作:
- 使用已删除的工作区打开文档。
- 展开文档菜单
:
- 选择“还原已删除的工作区”。
- 在对话框中,选择要还原的分支。
- 单击“还原选定内容”。

某个团队正在设计一款自行车,他们已实现了稳定的底架设计。现在是该团队对各种零部件设计进行试验的时候了。首先将底架设计文档标记为一个版本。
- 单击“版本和历史记录”图标
以在“文档”面板中打开“版本和历史记录”:
- 单击“创建版本”图标
。
- 将第一个版本命名为“Base Frame”(底架),然后单击创建:
随后,每个设计者可以从 Base Frame(底架)版本创建其自己的工作区,或许标记为车座、车闸和减震器。
- 右键单击 Base Frame(底架)版本,然后单击“创建分支以创建工作区”:
- 将新工作区命名为“席位”,然后单击创建:
Base Frame(底架)版本仍存在,原始工作区(Main 工作区)也存在。此外,还有一个工作区,即车座。所以,设计者对车座进行更改不会影响 Base Frame(底架)工作区。
- 减震器和车闸的设计者从同一 Base Frame(底架)版本创建各自的工作区:
此时,每位设计师的工作区都与 Base Frame(底架)版本相同。 - 随着他们继续在自己的分支机构中进行设计,他们的设计会不断发展,独立于 Base Frame(底架)版本,也彼此独立。当他们工作时,他们可以自由创建工作区的版本。
独立工作完成后,每个分支将合并回 Main 工作区,将所有独立工作汇集在一起。

图例
A typical Versions and history graph contains icons that indicate the type of workspace, branch, version, or revision each node is. To more fully understand how to read the graph, consider this table:
图标 | 指示 |
![]() |
版本 |
![]() |
变更节点 |
![]() |
包含已核准发布的版本。 |
![]() |
包含发布的版本,该发布中包含已淘汰的条目。 |
![]() |
工作区。 |
![]() |
具有待决的修订的版本。 |
![]() |
A version in the Versions and history that was created automatically by Onshape; for example, when using the Update to latest option as explained later in this topic |
术语
- 版本 - 文档的已命名且已保存状态。版本不可变且与工作区分离。创建版本可捕捉特定时间点的工作区。您可以打开版本以及为版本建立分支。
在版本图中以正常文本和实心点来指示。
- 工作区 - 建模/设计空间。
活动的工作区在版本图列表中以其左侧的蓝框来指示,关联分支末尾有一个实心点。
- 分支 - 拆分文档并创建新工作区的地方。一个分支可以有零个或多个版本,最多一个工作区。您可以打开和删除分支。
用粗体和斜体文本以及版本图表上的一个点表示。如果该点处于打开状态,则该分支具有一个关联的工作区。如果该点已关闭,则与该分支关联的工作区已被删除
。
合并线
所有合并都明确显示在“版本和历史记录”图表中,随着文档的更改,该图表会自动更新。
显示和隐藏合并线
为了使“版本和历史记录”图表更易于可视化,请根据需要切换“显示/隐藏合并”和“显示/隐藏自动版本”按钮:
在 Onshape 浏览器应用程序中显示了合并行和自动版本的版本和历史记录图表(上图)。
在 Onshape 浏览器应用程序中隐藏了合并的版本和历史记录图表(上图)。
在 Onshape 浏览器应用程序中隐藏了自动版本的版本和历史记录图表(上图)。
合并线示例
以下示例显示了包含多个分支的复杂“版本和历史记录”图表。每个分支都是从 Main 工作区创建的,然后在每个分支上完成单独的工作。随着每个分支的工作完成,这些分支被合并回了 Main 中。进出 Main 分支的线流显示了合并工作流程,便于查看何时合并了哪些更改。
Onshape 浏览器应用程序上显示了带有多个分支的版本和历史记录图表(上图)。
要自动滚动到分支的顶部或底部,请右键单击分支访问快捷菜单,然后选择“滚动到分支顶部”或“滚动到分支底部”选项。

通过搜索历史记录可以在所有版本和分支中搜索历史记录条目。结果是基于搜索词进行筛选的条目列表。版本名称和版本说明不包含在搜索中。
要搜索历史记录,请执行以下操作:
-
在“搜索历史记录”输入框中输入搜索词。所有历史记录条目(包括搜索词)都显示在“版本和历史记录”列表中:
-
(可选)要进一步缩小搜索范围,请单击“搜索历史记录”输入框中的下拉箭头。这使您可以使用以下条件筛选搜索:
-
选项卡 - 通过选择特定文档选项卡来缩小搜索范围。默认为“任何”选项卡。
-
选项卡类型 - 通过选择 Part Studio、装配体或工程图缩小搜索范围。默认搜索使用所有选项卡类型。单击清除按钮可重置选项卡类型筛选器。两个选项卡类型都包含在搜索中。
-
修改者 - 通过选择进行历史更改的人员来缩小搜索范围。选项包括“只有我”、“不是我”或“任何”(默认)。
-
修改日期 - 通过选择开始日期和结束日期缩小搜索范围。默认情况下会搜索所有日期。
-
选择条件后,单击搜索按钮。搜索词将根据新条件进行筛选。您可以随时单击重置按钮将所有筛选条件设置为其默认值。
进行搜索时,将从所有分支提供结果,即使您选择了“搜索”输入框上方的“活动分支”也是如此。

筛选分支按钮可更改版本图表中显示的分支。
若要筛选分支:
- 打开“版本和历史记录”面板。
- 单击“筛选分支”按钮。
- 选择筛选选项:
- 显示所有分支 - 显示版本图中的所有分支。默认视图。
- 显示所有包含工作区的分支 - 隐藏属于已删除工作区的所有分支。在下图中,您会看到底部的绿色分支(在上图中)已被隐藏。此选项可用于清理大型版本图。
- 显示当前分支 - 仅显示当前分支。
- 显示具有父分支的当前分支 - 仅显示当前分支及其父分支。
- 显示所有分支 - 显示版本图中的所有分支。默认视图。

With the Versions and history panel, you can create versions (which are read-only) and branch a version to create a new workspace.

您可以从“文档”页面或在文档内部打开“版本和历史记录”面板:
- 在“文档”页面上 - 选择与要打开版本和历史记录面板的文档对应的信息面板图标,然后轻按版本。
- 在文档中,轻按图形区域左侧的版本和历史记录图标
。

- 版本和历史记录面板显示文档的默认版本图
- 默认情况下存在 Main 工作区和 Start 版本。
- 轻按以在查看所有分支和活动分支(图形区域中处于活动或打开状态的工作区)之间切换:
- 轻按“创建版本”
以创建版本。
- 轻按 X 关闭 “版本和历史记录” 面板。
图表以树的形式显示文档的所有版本和工作区。该图表按分支进行颜色编码。每个分支都是一种颜色,每个分支都以一个工作区结尾,工作区以空心点表示。分支名称以粗体和斜体文本显示。版本以实心点和普通文本表示,并且仅供查看。
活动分支是当前打开的工作区,以亮显的蓝色表示。在上图中,分支 B1 是活动分支。

- 版本 - 文档的已命名且已保存状态。版本不可变且与工作区分离。创建版本可捕捉特定时间点的工作区。您可以打开版本以及为版本建立分支。
在版本图中以正常文本和实心点来指示。
- 工作区 - 建模/设计空间。
活动的工作区在版本图列表中以其左侧的蓝框来指示,关联分支末尾有一个实心点。
- 分支 - 拆分文档并创建新工作区的地方。一个分支可以有零个或多个版本,最多一个工作区。您可以打开和删除分支。
用粗体和斜体文本以及版本图表上的一个点表示。如果该点处于打开状态,则该分支具有一个关联的工作区。如果该点已关闭,则与该分支关联的工作区已被删除
。

要创建文档的版本:
- 打开“版本和历史记录”面板
。
- 轻按要创建版本的工作区或分支以将其选中。
- 轻按
。
- 为版本添加名称和说明,然后选择 创建版本。
- 新创建的版本显示在“版本和历史记录”面板中。
工作区(分支)以空心点来指示。

当您从一个版本分支时,您正在创建一个可以包含其他版本的新分支,并在分支的顶端(末端)创建一个新的工作区。
- 打开“版本和历史记录”面板
。
- 轻按要分支的版本(主版本除外)旁边的三点菜单图标(开始,在下图中),然后轻按“分支”创建工作区。
- 为分支添加名称和说明,然后选择创建工作区。
- 新创建的分支显示在“版本和历史记录”面板中。

With the Versions and history panel, you can create versions (which are read-only) and branch a version to create a new workspace.

您可以从“文档”页面或在文档内部打开“版本和历史记录”面板:
- 从“文档”页面中:
选择与要打开版本和历史记录面板的文档相对应的信息面板图标。从这里轻按版本。
- From within the document:
Tap the Versions and history icon
on the left side of the graphics area.

- The Versions and history panel displays the default version graph for a document. There is a Main workspace and a Start version by default.
- 版本和历史记录面板的右上角有两个图标:
- 创建版本
- 关闭“版本和历史记录”面板
- 轻按面板顶部的标签,在查看所有分支和活动分支(当前在图形区域中打开的工作区)之间切换:
该图表以树的形式显示文档的所有版本和工作区。图表按分支进行颜色编码。每个分支都是一种颜色,分支名称以粗体和斜体文本显示。与分支关联的工作区显示为空心点。版本显示为实心点和普通文本,仅供查看。
活动分支是当前打开的工作区,由标题周围的蓝框指示。例如,在上图中,B2 是活动分支名称。

- 版本 - 文档的已命名且已保存状态。版本不可变且与工作区分离。创建版本可捕捉特定时间点的工作区。您可以打开版本以及为版本建立分支。
在版本图中以正常文本和实心点来指示。
- 工作区 - 建模/设计空间。
活动的工作区在版本图列表中以其左侧的蓝框来指示,关联分支末尾有一个实心点。
- 分支 - 拆分文档并创建新工作区的地方。一个分支可以有零个或多个版本,最多一个工作区。您可以打开和删除分支。
用粗体和斜体文本以及版本图表上的一个点表示。如果该点处于打开状态,则该分支具有一个关联的工作区。如果该点已关闭,则与该分支关联的工作区已被删除
。

要创建当前活动文档的版本,请执行以下操作:
- 在图形区域的左侧,轻按“创建版本”图标
。
- 输入新版本的名称(以及可选的描述),然后轻按创建。
要从其他工作区或分支创建版本,请执行以下操作:
- Tap the Versions and history icon
to open the Versions and history panel.
- 轻按要创建版本的工作区(或分支)以打开该工作区。
- 轻按面板顶部的“创建版本”图标
。
工作区(分支)以空心点来指示。
- 为版本添加名称和描述,然后轻按“创建”。
- 新创建的版本显示在“版本和历史记录”面板中。
轻按版本旁边的三点菜单可查看“特性”、“打开”和“分支到工作区”等选项。

当您从一个版本分支时,您正在创建一个可以包含其他版本的新分支,并在分支的顶端(末端)创建一个新的工作区。
- Tap the Versions and history icon
to open the Versions and history panel.
- 轻按以选择要从其创建分支的版本:
- 轻点版本旁边的三点菜单,然后轻按“分支”以创建工作区。
- 为分支添加名称和描述,然后轻按创建。
- 新创建的分支显示在“版本和历史记录”面板中。
若要获取其他学习中心资源,请在此处学习自定进度的课程:分支和合并(需要 Onshape 帐户)和文档历史记录和版本(需要 Onshape 帐户)。您也可以在此处学习路径课程:Onshape 基础知识:数据管理(需要 Onshape 帐户),以及此处的技术简报文章:了解和使用文档的历史数据(需要Onshape 帐户)和 Gitflow 版本管理(需要 Onshape帐户)。