Difference 命令

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

Visual Studio 2019 |Visual Studio 2022

Team Foundation 版本控制（TFVC）difference 命令比较（如果可能）显示两个文件、两个文件夹中的文件或架子集和本地或服务器文件之间的差异。

先决条件

有关详细信息，请参阅 默认 TFVC 权限。

语法

tf diff[erence] itemspec [/version:versionspec] [/type:filetype] 
[/format:format [/ignorespace] [/ignoreeol] [/ignorecase] [/recursive] 
[/options][/noprompt][/login:username,[password]]

tf diff[erence] itemspec itemspec2 [/type:filetype] [/format: format] 
[/ignorespace] [/ignoreeol] [/ignorecase] [/recursive] [/options] [/noprompt][/login:username,[password]]

tf diff[erence] [/shelveset:shelvesetname[;shelvesetowner]] 
shelveset_itemspec [/type:filetype] 
[/format: format] [/ignorespace] [/ignoreeol] [/ignorecase] 
[/recursive] [/options] [/noprompt][/login:username,[password]]

tf diff[erence] /configure

参数

参数

选项

言论

可以使用 difference 命令进行比较，以及是否可能出现以下两者之间的显示差异：

• 同一文件的两个不同的文件或两个版本。

• 文件夹中的一个或多个项目。

• 一个、一些或所有项位于 Azure DevOps 服务器上的货架集中。

可以使用 difference 命令比较版本控制和非版本控制的文件。

TFVC 按类型对所有文件进行分类。 只要这两个文件具有相同的编码，就可以逐行合并和比较文本文件。 如果要比较两个编码不相同的文件，可以使用 /type 选项暂时屏蔽或替代文件的编码属性。

可以比较二进制文件，但无法合并。 将一个或多个二进制文件传递给 difference 命令时，TFVC 指示它与要比较的项之间是否存在差异。 有关 TFVC 如何区分和处理不同类型的文件的详细信息，请参阅 管理文件类型。

如果指定两个文件名，则比较两个文件。 你可以通过将分号和版本说明符追加到每个文件名末尾来指定版本，而不是使用 /version 标志。

如果只向差异命令传递一个 itemspec：

• 如果未提供 versionspec，则默认情况下，项目的当前工作区版本与基本工作区版本进行比较。 例如，tf difference header.h 将当前版本的 header.h 与 header.h 所基于的版本进行比较。

• 如果在 versionspec中包含 itemspec（例如 tf difference header.h;LBeta1），TFVC 会将该版本与磁盘上的当前工作区版本进行比较。

• 如果指定一系列版本（如 /version:C1~C4），则比较范围两个终结点处的文件版本。

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

输出格式类型

与 format 选项一起使用的 /format 参数指定许多不同的输出格式。 以下输出类型可用：

• Visual 格式类型会打开外部差异应用程序。 默认情况下，将启动 diffmerge.exe。

• Brief 格式打印要比较的文件是否不同。

• Context 格式为文件中的差异提供上下文行。 此格式派生自基于 UNIX 的 diff -c 输出格式。

• RCS 格式类似于 /format:unix，但未提供上下文行。 未提供文件末尾缺少行标记端的特殊手法。

• SS 是 Visual SourceSafe 的默认差异输出格式。 有关详细信息，请参阅 Diff （命令行）。

• SS_SideBySide 是 Visual SourceSafe 的默认并行输出格式。

• SS_Unix 类似于 /format:unix 输出格式，但 /format:ss_unix 包括上下文行和 /format:unix。

• Unified 格式派生自基于 UNIX 的 diff -u 输出格式。 /format:context 在差异字符串之间重复相同的上下文行，但 /format:unified 不重复。

  仅当与下一个差异字符串的距离大于上下文行数时，Unified 格式才会生成新的统一差异字符串（@@ ... @@）行。

• Unix 输出类型派生自基于 UNIX 的 diff 命令输出格式。

  Unix 输出格式采用以下方式构造：

  <metadataline>
  "< " line prefix for lines from the first file
  "---" line
  "> " line prefix for lines from the second file
  
  <metadataline> can be one of these possibilities:
  #a#,# -- add lines from line # in file1 into file2 at lines #->#
  #,#d# -- delete lines from line # -> # in file 1 from file2 at line #
  #,#c#,# -- change lines from line # -> # in file1 into the lines in file2 at line # -> #
  
  # signs separated by commas indicate a line range.
  # signs before the character indicate line numbers in the first file.
  # signs after the character indicate line numbers in the second file.
  
  /// No end of line marker at the end of the file:
  /// \ No newline at end of file
  

例子

以下示例显示本地版本的 314.cs 和工作区版本的 314.cs 之间的差异，即从 Azure DevOps 服务器签出的文件版本。

c:\projects>tf difference 314.cs

以下示例显示 src 文件夹中已更改的所有文件，但不显示已在 src子文件夹中更改的文件。

c:\projects>tf difference src /format:visual

以下示例显示更改集 3 和更改集 8 1254.cs之间的差异。

c:\projects>tf difference /version:C3~C8 1254.cs

以下示例显示属于标签 的 release 版本与属于 changeset 3200 的版本之间的差异。

c:\projects>tf difference 314.cs;Lrelease 314.cs;C3200

-或-

c:\projects>tf difference 314.cs;Lrelease~C3200

以下示例显示 e271.cs 版本之间的差异，即名为 Pat 的用户在货架集 PeerCodeReview8 中搁置，以及基于其更改的基本货架版本。 输出还显示用户搁置时 e271.cs 挂起的更改类型。

c:\projects> tf difference /shelveset:PeerCodeReview8;Pat e271.cs

以下示例显示 PeerCodeReview2 货架集中的所有文件与这些文件的基本货架版本之间的差异。

c:\projects> tf difference /shelveset:PeerCodeReview2

相关文章

• Merge 命令
• Checkin 命令
• 架集命令
• 管理文件类型
• 比较文件夹和文件