使用英语阅读

通过

Reconcile 命令（Team Foundation 版本控制）

  • 项目

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

Visual Studio 2019 | Visual Studio 2022

Team Foundation 版本控制 (TFVC) tf reconcile 命令将磁盘上工作区的当前状态与服务器的视图进行比较，以清理工作区或提升未挂起的本地更改。

先决条件

请参阅默认 TFVC 权限。

语法

tf reconcile [itemspec]
/clean [/diff] [/noprompt] [/preview] [/recursive] [/ignore]
[/unmapped] [/exclude:itemspec1,itemspec2,...] 

tf reconcile [itemspec]
/promote [/adds] [/deletes] [/diff] [/noprompt] [/preview]
[/recursive] [/noignore] [/exclude:itemspec1,itemspec2,...]

参数

参数

Argument

说明

<itemspec>

标识要对其应用 reconcile 命令的文件或文件夹。 如果省略，则包含所有合适的项。 若要详细了解 TFVC 如何分析 itemspec 以确定哪些项在范围内，请参阅使用 Team Foundation 版本控制命令。

备注

可指定多个 itemspec 参数。

选项

选项

说明

/clean

更新磁盘上的本地项以匹配服务器的结构。 删除版本控制中不存在的项，并添加磁盘上缺少但版本控制中存在的项。

/promote

将本地文件更改提升到版本控制。 将本地创建的项添加到版本控制，类似于 tf add，并删除已本地删除的项。

备注

与 /noprompt 一起使用时请指定 /adds 和/或 /deletes。

/adds

将本地添加的文件和文件夹提升到版本控制。

备注

只能与 /promote 一起使用。

/deletes

将已删除的文件和文件夹提升到版本控制。

备注

只能与 /promote 一起使用。

/exclude

忽略此选项中指定的逗号分隔项。

备注

对于交集，此选项将替代 /ignore、/noignore 和 /unmapped 选项。

/unmapped

替代默认值，并清理未映射和已掩蔽的项。 默认情况下，未映射和已掩蔽的项不受 /clean 命令的影响。 有关详细信息，请参阅映射（工作区）。

备注

只能与 /clean 一起使用。

/diff

使用 MD5 哈希将项与源代码管理进行比较。 使用此选项可检测与工作区版本不同但仍设置了只读位 (+R) 的项。

/preview

显示将发生的情况，而不实际执行 reconcile 操作。

/ignore

替代默认值，但不更改已忽略的项。 默认情况下，/clean 根据当前服务器状态更新所有项，包括被版本控制忽略的项。 使用此选项可避免更改已忽略的项。

可以使用 .tfignore 文件配置要忽略的项。 有关详细信息，请参阅自定义版本控制忽略的文件。

备注

只能与 /clean 一起使用。

/noignore

替代默认值，并提升已忽略的项。 默认情况下，/promote 会提升除版本控制忽略的项之外的所有项。 使用此选项可以提升已忽略的项。 此选项类似于在 tf add 命令中使用 /noignore。

备注

只能与 /promote 一起使用。

/recursive

协调特定目录和子目录中的项。

/noprompt

禁止显示窗口和对话框，并将输出数据重定向到命令提示。 请参阅使用 Team Foundation 版本控制命令。

注解

可以使用 reconcile 命令将本地工作区状态与服务器状态同步。

  • 使用 /clean 根据服务器的状态更新本地工作区。
  • 使用 /promote 将本地添加和删除的项提升为版本控制中的挂起的更改。

有关如何使用 tf 命令行实用工具的详细信息，请参阅使用 Team Foundation 版本控制命令。

示例

clean

以下示例打开 Visual Studio“清理工作区”对话框，以便可以指定应从服务器删除或重新下载的本地项。

tf reconcile /clean

以下示例清理除版本控制忽略的项之外的所有本地项。

tf reconcile /clean /ignore

以下示例清理所有本地项，包括未映射和已掩蔽的项。

tf reconcile /clean /unmapped

以下示例清理除 file1.txt 和 dir1 以外的所有项及其所有内容，而不显示“清理工作区”对话框。

tf reconcile /clean /noprompt /recursive /exclude:file1.txt,dir1

升级

以下示例打开 Visual Studio“提升候选更改”对话框，以便可以指定应将哪些项提升为挂起的更改。

tf reconcile /promote

以下示例提升所有项，包括版本控制忽略的项，但 myLib.dll 文件除外。

tf reconcile /promote /noignore /exclude:myLib.dll

以下示例将所有本地创建的项添加到版本控制挂起的更改，而不打开“升级候选更改”对话框。 此命令类似于 tf add /noprompt 命令。

tf reconcile /promote /adds /noprompt

以下示例将所有本地删除的项添加到版本控制挂起的更改，而不打开“升级候选更改”对话框。

tf reconcile /promote /deletes /noprompt