Difference 命令

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

Visual Studio 2019 |Visual Studio 2022

Team Foundation 版本控制 （TFVC） difference 命令會比較兩個檔案、兩個資料夾中的檔案，或擱置集和本機或伺服器檔案之間的差異。

先決條件

若要使用 difference 命令，請將所有指定項目設為 Allow的 Read 許可權。 如需詳細資訊，請參閱 預設 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 所依據的版本進行比較。

• 如果您在 itemspec中包含 versionspec，例如 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 之 314.cs 版本與屬於changeset3200的版本之間的差異。

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

相關文章

• 合併命令
• Checkin 命令
• 擱置集命令
• 管理檔類型
• 比較資料夾和檔案