向团队的代码库签入工作成果

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Visual Studio 2022 |Visual Studio 2019 |Visual Studio 2017 |Visual Studio 2015 |Visual Studio 2013

使用团队资源管理器中的 “挂起更改 ”页将代码签入新的变更集。 按 Ctrl+0键盘上的 P

Screenshot shows Pending Changes pane with a comment and Check In button.

选择要签入的文件

可以通过在团队资源管理器中“挂起的更改”页的“包含更改”和“排除的更改”部分之间拖动它们来指定要签入的文件更改。 还可以在Visual Studio的其他领域工作时签入:

  • 在解决方案资源管理器中,选择以下项之一:

    • 解决方案
    • 一个或多个代码项目
    • 一个或多个文件

    选择项目后,右键单击并选择 “签入”。

  • 在源代码管理器中,选择具有挂起的更改的一个或多个项或选择包含具有挂起的更改的项的一个或多个文件夹。 TFVC 签出状态图标 指示具有挂起更改的项目。 打开所选项的上下文菜单,然后选择 “签入”。

重要

如果未对所选项目进行挂起的更改,则不会显示 “签入 ”选项。

如果看不到项的挂起更改,请确保尚未将其列为排除的更改。 打开团队资源管理器的“挂起的更改”视图,然后选择“排除的更改”下的“检测到”链接。 检查列表中要包括的更改,然后选择“ 提升 ”,将排除的更改移动到 “包含的更改 ”部分。 现在可以签入这些更改。

关联工作项

签入更改时,应将工作项与更改相关联。 这种做法具有以下优势:

  • 查看工作项的团队成员可以直接 链接到变更集 ,以查看你所做的工作。
  • 评审所更改 文件历史记录的 团队成员可以查看更改集,并查看作为更改理由的工作项。
  • 可以在自动化生成系统中生成更改,例如使用 CI 生成封闭式签入生成。 团队成员可以查看已完成的生成任务或修复了 bug。

将工作项与更改相关联:

  • “相关工作项”部分选择“按 ID 添加工作项”链接。
  • 将工作项从工作组资源管理器的工作 查询窗口拖到 “相关工作项 ”部分。

在每个工作项旁边,选择与更改相关的方式: 关联解决。 仅当工作项尚未处于排除此关系的状态(如 已解决完成已关闭)时,这些选项才可用。

签入更改

  1. 在团队资源管理器中,选择 “开始”,然后选择“ 挂起的更改 ”或按 Ctrl+0P

  2. “待处理更改 ”页上,输入 “批注 ”,以便以后需要 查看和了解文件历史记录的 团队成员可以了解所执行的操作。 例如: 实现购物车控制器

  3. 某些团队希望其成员提供有关每个变更集的某些类型信息。 在某些情况下,他们甚至实施签入策略以要求这种做法。 如果项目的管理员 启用了签入笔记,则可以在 “备注 ”部分的每个字段中键入信息。

  4. 选择 “签入”。

出现以下结果之一:

  • 您的更改已签入

    工作区中包括的所有文件更改以及注释、签入笔记和相关工作项的链接将作为单个 更改集 存储在服务器上。

  • 冲突阻止更改

    系统为您显示对服务器上最新版本的文件的更改之间的冲突。 请参阅解决Team Foundation 版本控制冲突

  • 签入策略会阻止更改

    项目的管理员可以实施签入策略,以鼓励团队遵循最佳做法。 例如,签入策略可鼓励团队成员将至少一个工作项与其更改关联。 有关详细信息,请参阅 设置和强制实施质量入口

    在某些情况下,你可能希望重写这些签入策略。 在 “策略警告 ”部分中,选择“ 替代警告”。

    “原因” 框中,说明为何选择替代策略。

  • 签入对受封闭签入生成过程控制的文件夹的更改

    Screenshot shows the Gated Check-in dialog box with a message.

    如果要将更改签入到受 封闭签入生成过程控制的版本控制文件夹中,将显示 “封闭式签入 ”对话框。 有关如何完成签入操作的信息,请参阅 签入到受封闭签入生成过程控制的文件夹

订阅警报

如果要在 TFVC 项目中签入代码时收到通知,可以 订阅 以接收电子邮件警报。 选择 “签入警报”。

Screenshot shows the alerts page for a T F V C project in web portal.

从命令提示符处工作

提示

  • 可以从 团队资源管理器取消停靠 “挂起的更改 ”页,并在新窗口中打开它。

  • 可以从 “操作” 菜单在列表视图和树视图之间切换。

  • 在签入新代码之前,应考虑执行代码评审。 请参阅 “挂起”工作、修复 bug 并执行代码评审

  • 可以根据需要管理和撤消挂起的更改。 请参阅 开发代码和管理挂起的更改

  • 如果需要保留更改,请参阅 “暂停工作并管理货架集”。

  • 更改以原子方式签入。 操作要么完全成功,要么完全失败,但有一个例外。 如果任何一项更改无法提交到Team Foundation Server,则不会提交任何更改,也不会创建变更集。 例如,如果在签入操作中间丢失网络连接,则整个操作将失败。

    例外情况是工作项与变更集的关联。 如果工作项关联失败,但签入操作的所有其他方面都成功,则会创建更改集。 您可以手动将工作项与变更集关联。 请参阅 “管理依赖项”,链接工作项以支持可跟踪性

后续步骤

重命名或移动文件和文件夹