使用标签拍摄 Azure Repos 中文件的快照

项目
01/14/2025

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

Team Foundation 版本控制（TFVC）标签提供了一种拍摄文件快照的方法。以后可以返回参考该快照。通过使用标签，您可以查看、构建甚至回滚一大组文件，将它们恢复到应用标签时的状态。

先决条件

要应用标签，必须将标签权限设置为允许。
若要查找、列出或查看标签，请将读取权限设置为允许。
要修改或删除标签，必须是标签的所有者或者将“管理标签”权限设置为“允许”。

使用标签

在许多软件项目中，当代码达到合理的质量和稳定性级别时，团队将生成并发布新版本的产品。团队需要标记每个文件的当前版本。即使文件继续更改，团队仍然可以获取和生成项目中每个文件的新版本。

从理论上讲，你可以手动记录每个文件的每个变更集的 ID。但这种过程并不实用。 TFVC 使作业变得简单。将标签应用于包含文件的文件夹、分支或项目。你可以为标签指定一个名称，该名称遵循你喜欢的任何命名约定。标签名称的一些示例包括：“Sprint 5”、“M1”、“Beta2”和“发布候选版本 0”。

应用标签后，可以使用它来限定构建、分支、合并、比较和获取特定版本的文件和文件夹等操作。

有时，应用标签后，你决定需要更改它。 TFVC 提供了一种将标签应用于其他文件、从某些文件中删除标签以及修改标签适用的特定文件版本的方法。

提示

应用标签可提供许多与创建分支相同的优势，但通常成本较低且复杂性较低。缺点在于，对于大型数据库，在针对标签运行时，诸如合并之类的操作花费的时间可能比平时长得多。

应用标签

注意

使用 Visual Studio 应用已存在的标签时，该操作将从所有文件版本中删除标签，然后应用标签。但是从命令提示符操作时，该标签操作是追加性的。请参阅标签命令（Team Foundation 版本控制）。

在 Visual Studio 的“视图”菜单上，选择“其他窗口”>“源代码管理器”。
在源码管理器中，右键单击要应用标签的集合、项目、分支、文件夹或文件，然后选择高级>应用标签。此时将显示“新建标签”对话框。
在名称框中，输入标签的名称。
（可选）在批注框中，输入批注。
在版本列表中，默认选择 最新版本。此选项是最常用的选项。如果需要标签以特定版本为目标，请选择以下选项之一：
- 变更集：在变更集框中指定变更集的编号。或者，选择省略号 (…) 以打开“查找变更集”对话框。有关详细信息，请参阅查找和查看变更集。
- 日期：在日期框中指定日期或从下拉菜单的日历中选择日期。
- 标签：指定一个现有标签作为新标签的基础。在“标签”框中输入标签名称，或选择省略号（...）打开 查找标签 对话框。有关详细信息，请参阅查找、编辑和删除标签。
- 工作区版本：为工作区中的版本创建标签。
对设置感到满意时，请执行以下步骤之一：
- 若要应用标签，请选择创建。
- 要应用标签并在应用后对其进行修改，请选择 创建和编辑。此操作会应用标签，然后显示“标签”窗口。有关使用标签窗口编辑标签的详细信息，请参阅使用“标签”窗口处理标签。

注意

应用已存在名称的标签时，系统会发出警告并询问是否要继续。如果选择“确定”并继续，则 TFVC 会从不在要应用标签的路径中的所有项移除该标签。

重命名标签

不能修改现有标签的名称。但是，可以轻松地将新标签应用于完全相同的文件和另一个标签适用的版本。

在源代码管理器中，右键单击项目集合节点（根节点），然后选择“高级”>“应用标签”。此时将显示“新建标签”对话框。
在名称框中，输入标签的名称。
（可选）在批注框中，输入批注。
在“版本”列表中选择“标签”。此时将显示“标签”框。
执行以下步骤之一：
- 输入现有标签的名称。
- 如果不确定现有标签的名称，请选择标签框旁边的带有省略号（...）的浏览按钮。 “查找标签”对话框随即显示。使用 查找标签 对话框中的选项筛选标签列表，并查找要向其应用新标签的现有标签。有关详细信息，请参阅查找、编辑和删除标签。
选择创建。
（可选）创建新标签后，可以删除旧标签。有关详细信息，请参阅查找、编辑和删除标签。

列出、查找、查看、编辑和删除标签

可通过两种方式列出和查找标签：“查找标签” 对话框和“历史记录”窗口中的“标签”选项卡。找到感兴趣的标签后，可以查看、编辑或删除它。还可以处理应用了标签的文件。

使用“查找标签”对话框查找和使用标签

在源代码管理资源管理器的菜单栏上，选择文件>源代码管理>查找>查找标签。 “查找标签”对话框随即显示。
（可选）通过执行以下步骤中的一个或多个来优化搜索：
- 在名称文本框中，输入标签的名称。
- 在项目列表中，选择包含要查找的标签的项目。
- 在 所有者 文本框中，输入标签所有者的名称或别名。
选择查找。结果列表中显示了符合您输入的搜索条件的标签。
（可选）执行以下步骤之一：
- 若要查看或编辑标签，请选择标签，然后选择编辑。 “标签”窗口随即显示。有关详细信息，请参阅使用“标签”窗口处理标签。
- 若要删除标签，请选择它并选择删除。
- 选择关闭。

列出和使用应用于特定项的标签

有时，你可能不确定标签的名称，但你知道标签已应用于版本控制下的特定项。以下过程说明在这种情况下如何查找和使用标签。

在源代码管理器中，右键单击应用了标签的项，然后选择“查看历史记录”。此时将显示“历史记录”窗口。
选择标签选项卡以显示应用于此项的标签列表。
（可选）执行以下步骤之一：
- 若要查看或编辑标签，请右键单击标签，然后选择“编辑标签”。 “标签”窗口随即显示。有关如何使用此窗口的信息，请参阅使用“标签”窗口处理标签。
- 若要删除标签，请右键单击标签，然后选择“删除标签”。
- 右键单击标签，然后选择其他操作，例如 获取此版本 或比较。

有关如何在 历史记录 窗口中使用标签选项卡的详细信息，请参阅获取项的历史记录。

将已标记的文件版本下载到您的工作空间

标记一组文件就像在特定时间点记录下它们当时状态的快照。创建此快照后的数周或数月，你可能需要查看或处理在该快照中存在的文件。以下过程介绍如何将一组文件的标记版本下载到工作区。

在源代码管理资源管理器中，右键单击项目集、项目、分支或包含要下载项的文件夹，然后选择“高级>获取特定版本”。此时会显示“获取”对话框。
在类型列表中，选择标签，然后在标签框中输入标签名称，或选择省略号（...）打开 查找标签 对话框。有关如何使用此对话框的详细信息，请参阅查找、编辑和删除标签。
在“获取”对话框中选择任何其他适当的选项。
选择获取。

使用“标签”窗口来管理标签

使用上述过程之一打开标签窗口后，即可开始使用标签。在窗口顶部，一个框显示可以编辑的批注。

可以使用标签窗口执行以下任务：

向标签中添加项
从标签中删除项
更改文件的版本
对项目执行其他操作

向标签中添加项

在标签窗口中，选择 添加项。 “选择项版本”对话框随即显示。
在 “选择项版本” 对话框中，导航到要添加的项，然后选择它。

提示

可以选择并按住 Ctrl 或 Shift 键，然后选择多个项目。
（可选）如果需要标签以特定版本为目标，请从版本列表中选择一个版本：
- 最新版本：将标签应用于处于版本控制下的最新版本。
- 变更集：在变更集框中指定变更集的编号。或者，选择省略号 (…) 以打开“查找变更集”对话框。有关详细信息，请参阅查找和查看变更集。
- 日期：在日期框中指定日期或从下拉菜单的日历中选择日期。
- 标签：指定一个现有标签作为新标签的基础。在“标签”框中输入标签名称，或选择省略号（...）打开 查找标签 对话框。有关详细信息，请参阅查找、编辑和删除标签。
- 工作区版本：为工作区中的版本创建标签。
选择“确定”。
选择文件>保存。

从标签中删除项

在“标签”窗口中，找到要从此标签中删除的集合、项目、分支、文件夹或文件。
右键单击该项并选择 从标签中删除。标签将从项中删除。如果项是项目集合、项目、分支或文件夹，则标签也会从它包含的所有项中删除。
选择文件>保存。

更改文件的版本

在“标签”窗口中，找到要修改的文件。
右击该文件，然后选择 更改标签版本。 “更改已设置标签的版本”对话框随即显示。
选择以下值之一：
- 最新版本：将标签应用于处于版本控制下的最新版本。
- 变更集：在变更集框中指定变更集的编号。或者，选择省略号 (…) 以打开“查找变更集”对话框。有关详细信息，请参阅查找和查看变更集。
- 日期：在日期框中指定日期或从下拉菜单的日历中选择日期。
- 标签：指定现有标签作为新标签的基础。在“标签”框中选择标签名称，或选择省略号（...）以打开 “查找标签”对话框。有关详细信息，请参阅查找、编辑和删除标签。
- 工作区版本：为工作区中的版本创建标签。
选择文件>保存。

对带标签项执行其他操作

在“标签”窗口中右键单击某个项时，还可以选择以下命令之一：

查看（仅限文件）
查看历史记录
比较（仅限文件）
批注（仅限文件）
获取此版本

在命令提示符下工作

使用 labels 命令列出标签。有关详细信息，请参阅标签命令。
使用 label 命令应用或删除标签。有关详细信息，请参阅标签命令（Team Foundation 版本控制）。

提示

使用 label 命令应用标签时，可以指定项目以外的范围。

通过