共用方式為

Difference 命令

  • 發行項

更新：2007 年 11 月

比較兩個檔案、兩個資料夾中的檔案，或擱置集和本機或伺服器檔案，並顯示兩者間的差異。

必要的使用權限

若要使用 difference 命令，您必須將所有指定之項目的 [讀取] 權限設定為 [允許]。如需詳細資訊，請參閱 Team Foundation Server 使用權限。

tf diff[erence] itemspec [/version:versionspec] [/type:filetype] 
[/format:format [/ignorespace] [/ignoreeol] [/ignorecase] [/recursive] 
[/options]

tf diff[erence] itemspec itemspec2 [/type:filetype] [/format: format] 
[/ignorespace] [/ignoreeol] [/ignorecase] [/recursive] [/options]

tf diff[erence] [/shelveset:shelvesetname[;shelvesetowner]] 
shelveset_itemspec [/server: servername] [/type:filetype] 
[/format: format] [/ignorespace] [/ignoreeol] [/ignorecase] 
[/recursive] [/options]

tf diff[erence] /configure

參數

引數

描述

itemspec

必要項。指定要比較的項目。如果沒有指定版本或路徑，就會採用「目前的工作區版本」(Current Workspace Version)。本機與 Team Foundation 版本控制伺服器路徑均可接受。

如需 Team Foundation 如何剖析 itemspecs 以便判斷哪些項目位於範圍內的詳細資訊，請參閱命令列語法 (Team System)。

difference 命令不支援萬用字元。

這個參數無法與 /shelveset 選項合併使用。

Itemspec2

選擇項，要與 itemspec 進行比較的項目。如果未提供第二個 itemspec，則將使用項目的最新 Team Foundation 版本控制伺服器版本。

Filetype

提供 /type 選項的值。您可以將字碼頁指定為 "binary" 或 "text"，也可為其指定字碼頁編號或易記名稱。

Format

與 /format 選項搭配使用，以指定下列一種類型的輸出格式：

  • Visual

  • Brief

  • Context

  • RCS

  • SS

  • SS_SideBySide

  • SS_Unix

  • Unified

  • Unix

這些輸出格式會在本主題的＜備註＞章節中說明。

Versionspec

/version 選項的使用者提供值。如需 Team Foundation 如何剖析版本規格以便判斷哪些項目位於範圍內的詳細資訊，請參閱命令列語法 (Team System)。

servername

/server 選項的使用者提供值。範例：teamfoundation2。

Shelvesetowner

藉由使用者名稱辨別擱置集的擁有人。如果未提供這個參數的值，就會採用目前的使用者。

Shelvesetname

指定擱置集的名稱。請注意，Team Foundation Server 上可以有一個以上的名稱相同的擱置集，只要每個擱置集是由不同的使用者所擁有。

Shelveset_itemspec

指定擱置集中要與基本擱置集版本比較的資料夾或檔案的名稱。

選項

描述

/type

覆寫任何偵測到的編碼方式，並使用指定的編碼方式向差異引擎代表檔案。

/version

指定要比較的檔案或資料夾的版本。依預設值，如果沒有提供 versionspec，Team Foundation 會使用工作區版本。

您可藉由在每個檔名結尾附加分號和版本規範來指定版本，而不需使用 /version 旗標。

/format

指定由 format 引數所指定的輸出格式。

/ignorespace

不反白顯示比較檔案之間的 white-space 差異。

/ignoreeol

忽略兩個檔案或檔案版本中的換行字元之間的差異。/ignoreeol 與 /ignoreSpace 的作業方式不同。/ignorespace 會將 8 個空格當成 1 個處理。不過，如果使用 /ignoreeol 選項，檔案 A 在未變更的文字區域之間有兩個換行字元，而檔案 B 有一個，則結果會顯示為一個差異。如果兩個檔案都只有一個換行，但檔案 A 使用 \r\n 當成新行，而檔案 B 使用 \n，則 /ignoreEOL 選項會忽略這點，不會將其當做差異。

/ignorecase

不會反白顯示比較的檔案之間的字母大小寫差異。

/recursive

比較現有資料夾及其所有子資料夾之間的差異。

/options

指定由 diff 所叫用工具的選項字串。如需詳細資訊，請參閱 HOW TO：使檔案類型與差異工具產生關聯和 HOW TO：使檔案類型與合併工具產生關聯。

/server

辨別 Team Foundation Server。如果此命令是從尚未對應至工作區的目錄叫用，就會需要這個選項。

/shelveset

指定擱置集，以與該擱置集所根據的 Team Foundation 版本控制伺服器版本進行比較。

這個選項無法與 itemspec 引數合併使用。若要比較個別的擱置集項目，您可以提供 shelveset_itemspec。

/noprompt

隱藏在完成此作業時要顯示的任何對話方塊。

/configure

叫用 [設定使用者工具] 對話方塊。您可以從 Visual Studio 使用者介面使用這個工具。如需詳細資訊，請參閱 HOW TO：使檔案類型與差異工具產生關聯。

備註

注意事項：

您可以在命令列輸入 tf diff 或 tf difference 以執行此命令。

您可以使用 difference 命令以進行比較並顯示之間的差異 (如有可能)：

  • 兩個不同的檔案或同一檔案的兩個版本。

  • 資料夾中的一或多個項目。

  • Team Foundation Server 上的擱置集中的一個、某些或所有項目。

您可以使用 difference 命令比較已建立版本和沒有建立版本的檔案。

Team Foundation 會依類型將所有檔案分類。文字檔可以並排而逐行地合併及比較，只要兩個檔案都具有相同的編碼方式即可。如果想要比較編碼方式不同的兩個檔案，可以藉由使用 /type 選項，暫時將檔案的編碼方式屬性加以遮罩或覆寫。二進位檔案可以比較，但不能合併。當您將一或多個二進位檔案傳遞到 difference 命令時，Team Foundation 會指出在它及要比較的項目之間是否有差異存在。如需 Team Foundation 如何區分及處理不同類型檔案的詳細資訊，請參閱檔案類型。

如果指定兩個檔案名稱，就會比較這兩個檔案。您可藉由在每個檔名結尾附加分號和版本規範來指定版本，而不需使用 /version 旗標。

如果只傳遞一個 itemspec 給 difference 命令：

  • 如果未提供版本規格，則根據預設，項目目前的工作區版本會與基底工作區版本比較。例如，tf difference header.h 會將 header.h 目前的版本與做為 header.h 基礎的版本做比較。

  • 如果在項目規格中包含版本規格 (例如，tf difference header.h;LBeta1)，Team Foundation 就會將該版本與磁碟上目前的工作區版本進行比較。

  • 如果指定 /version:C1~C4 之類的版本範圍，則會比較該範圍兩個結束點的檔案版本。

如需如何尋找 tf 命令列公用程式的詳細資訊，請參閱 Tf 命令列公用程式命令。

輸出格式類型

搭配 /format 選項使用的 format 參數可指定許多不同的輸出格式。可用的輸出類型為

  • Visual

    Visual 格式類型會開啟外部的差異應用程式。依預設會啟動 diffmerge.exe。

  • Brief

    Brief 格式會列印出進行比較的檔案是否有所差異。

  • Context

    Context 格式針對檔案中的差異提供內容行。這個格式是根據 diff ¡Vc 輸出格式從 UNIX 所衍生。

  • RCS

    RCS 格式類似於 /format:unix，只是不會提供內容行。

    不會為檔案結尾遺失的行標記結尾提供特殊的處理。

  • SS

    SS 是 Visual SourceSafe 的預設差異輸出格式。如需詳細資訊，請參閱 Microsoft 網站上的 "Diff (File) (Command Line)" (英文) (https://go.microsoft.com/fwlink/?LinkId=99139)。

  • SS_SideBySide

    SS_SideBySide 是 Visual SourceSafe 的預設並排輸出格式。

  • SS_Unix

    SS_Unix 類似於 /format:unix 輸出格式，但 /format:ss_unix 包含內容行，/format:unix 則不包含。

  • Unified

    Unified 格式是從 UNIX 架構的 diff ¡Vu 輸出格式所衍生。/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 seprated by commas indicate a line range.
# signs before the character indicate line numbers in the first file
# signs after the character indidicate 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 工作區版本之間的差異，後者是從 Team Foundation 版本控制伺服器所簽出檔案的版本。

c:\projects>tf difference 314.cs

下列範例顯示已在 src 資料夾中變更過的所有檔案。不會顯示已在 src 子資料夾中變更過的檔案。

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

下列範例會顯示 1254.cs 之變更集 3 和變更集 8 之間的差異。

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

下列範例顯示屬於 "release" 標籤的 314.cs 版本以及屬於變更集 3200 的版本之間的差異。

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

- 或 -

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

下列範例顯示名為 Nadia 的使用者擱置在 PeerCodeReview8 中的 e271.cs 版本以及該使用者用來做為變更依據的「基本擱置集版本」(Base Shelveset Version)之間的差異。還會顯示在 Nadia 擱置時暫止於 e271.cs 的變更類型。

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

下列範例顯示 PeerCodeReview2 擱置集中的所有檔案以及這些檔案的基本擱置集版本之間的差異。

c:\projects> tf difference /shelveset:PeerCodeReview2

請參閱

概念

檔案類型

參考

Merge 命令

Checkin 命令

Shelvesets 命令

其他資源

Tf 命令列公用程式命令

在版本控制中比較資料夾和檔案