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

  • 项目

使用**“挂起的更改”**页（键盘：Ctrl + 0, P）将您的代码签入到团队的基本代码。

Checking in an update to fix a bug

您希望做什么？

  • 指定要签入的文件

  • 关联工作项

  • 签入更改

  • 解决签入策略警告

  • 执行封闭签入

  • 订阅警报

  • 从命令提示符处工作

  • 获取提示

指定要签入的文件

您可以通过在**“挂起的更改”页的“包含的更改”和“排除的更改”**部分之间拖动文件更改来指定将要签入的文件更改。 当您在 Visual Studio 的其他区域工作时，您还可以限定签入的范围：

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

    • 解决方案

    • 一个或多个代码项目

    • 一个或多个文件

    选择项目后，打开其上下文菜单，并选择**“签入”**。

  • 在源代码管理资源管理器中，选择具有挂起的更改的一个或多个项或选择包含具有挂起的更改的项的一个或多个文件夹。（具有挂起的更改的项由以下符号表示：TFSC Checked-Out Status Icon）。 打开所选项的上下文菜单，然后选择**“签入”**。

关联工作项

在基本代码中更改文件时，您通常要执行此操作来完成任务、修复 Bug 或满足其他一些种类的工作项的需求。 在签入更改时，您应将此类工作项与要签入的更改关联。 这样做有以下好处：

  • 查看工作项的团队成员可以直接链接到变更集以查看您的工作。

  • 查看文件的历史记录的团队成员可以查看变更集并看到作为更改的理由的工作项。

  • 如果您在自动生成系统中生成更改（例如，使用 CI 生成或封闭签入生成），团队成员可以看到任务在哪个已完成的生成中完成，或 Bug 在哪个已完成的生成中修复。

将工作项与签入关联：

  • 选择**“相关工作项”部分的“按 ID 添加工作项”**链接。

  • 将工作项从查询窗口拖动到**“相关工作项”**部分。

在每个工作项旁边，选择它与签入的相关方式：“关联”或“解决”（仅当工作项尚未处于排除此关系的状态时可用，如**“已解决”、“已完成”或“已关闭”**）。

提示

您可以打开关联工作项的上下文菜单，然后选择：

  • “打开工作项”以在临时选项卡中打开工作项。如果要在常规选项卡中查看工作项，请打开选项卡的上下文菜单并选择“打开选项卡”（键盘：Ctrl + Alt + Home）。

  • “移除工作项”（如果您不希望将工作项与签入关联）。

  • “新链接的工作项”、“创建工作项的副本”或“连接到现有项”。

签入更改

签入更改

  1. 在团队资源管理器中，选择 Home icon“主页”，然后选择**“挂起的更改”**（键盘：Ctrl + 0, P）。

  2. 在**“挂起的更改”页上，输入“注释”**，以便稍后需要查看并了解您的文件的历史记录的队友了解您进行的操作。 例如：“实现了购物车控制器”。

  3. 某些团队更喜欢让其成员提供有关每个签入的某些种类的信息。 在某些情况下，它们甚至实施签入策略来要求执行此操作。 如果您的团队项目的管理员已经启用签入说明，则您可以在**“说明”**部分的每个字段中键入信息。

  4. 选择**“签入”**按钮。

将出现以下结果之一。

您的更改已签入

您的工作区中所有包含的文件以及注释、签入说明和相关工作项的链接将存储在服务器上（作为您的服务器上的单个变更集）。

冲突阻止您的签入

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

您的签入因违反签入策略而受阻。

团队项目的管理员可以实施签入策略以鼓励您的团队遵循最佳做法。 例如，签入策略可鼓励团队成员将至少一个工作项与其更改关联。 有关详细信息，请参阅Set and Enforce Quality Gates。

在某些情况下，您可能希望重写这些签入策略。 在**“策略警告”部分，选择“重写警告”**。

在**“原因”**框中，解释选择重写策略的原因。

签入到由封闭签入生成过程控制的文件夹

Gated Check-in dialog box

如果要将更改签入到由封闭签入生成过程控制的版本控制文件夹中，则会显示**“封闭签入”**对话框。 有关如何完成签入操作的信息，请参见签入由封闭签入生成控制的挂起的更改。

订阅警报

如果您要在某人将代码签入您的 TFVC 团队项目时获得通知，您可以订阅接收电子邮件警报。 此处是具体说明。

Alerts page for TFVC team project in web portal

从命令提示符处工作

提示

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

  • Tip 您可以通过**“操作”**菜单在列表和树状视图之间切换。

  • Tip在签入新代码前，应该考虑执行代码评审。 请参阅挂起工作，修复 bug，并执行代码评审。

  • Tip必要时，您可以管理和撤消挂起的更改。 请参阅开发代码和管理挂起的更改。

  • Tip 如果需要保留您的更改，请参阅暂停工作并管理搁置集。

  • Tip签入操作以原子方式执行 - 此操作要么完全成功要么完全失败（有一种例外情况）。 如果有任一更改无法提交到 Team Foundation Server，则所有更改均无法提交，且不会创建变更集。 例如，如果在签入过程中丢失网络连接，则整个操作将失败。

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