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

项目
04/04/2024

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”和“Release Candidate 0”。

应用标签后，即可将其用于限定操作，如生成、分支、合并、比较及获取文件和文件夹的特定版本。

有时，在应用标签后，你会决定需要对其进行更改。通过使用 TFVC，可以将标签应用于其他文件、从某些文件中移除标签、修改将标签应用到特定文件的哪个版本。

提示

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

应用标签

注意

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

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

注意

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

重命名标签

无法修改现有标签的名称。但可以轻松地将新标签应用于另一标签所应用到的那些完全相同的文件和版本。

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

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

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

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

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

列出并处理应用于特定项的标签

有时你可能不确定标签的名称，但知道标签已应用于处于版本控制下的特定项。下面的过程解释如何在此情况下查找和处理标签。

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

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

将文件的带标签版本下载到工作区

对一组文件创建标签类似于获取这些文件在某一时间点的情况的快照。在拍摄此快照的数周或数月后，可能需要按照这些文件在该快照中的存在情况进行查看或处理。下面的过程解释如何将一组文件的带标签版本下载到工作区。

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

使用“标签”窗口处理标签

通过上述任一过程打开“标签”窗口后，即可开始处理标签。在窗口顶部有一个显示注释的框，可以对其进行编辑。

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

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

向标签中添加项

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

提示

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

从标签中移除项

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

更改文件的版本

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

对带标签项执行其他操作

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

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

从命令提示符处工作

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

提示

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