Perintah perbedaan

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

Perintah difference Team Foundation Version Control (TFVC) membandingkan, dan jika memungkinkan, perbedaan antara dua file, file dalam dua folder, atau shelveset dan file lokal atau server.

Prasyarat

Kategori	Persyaratan
Permissions	Izin baca untuk semua item yang ditentukan diatur ke Izinkan.

Untuk informasi selengkapnya, lihat izin TFVC Default.

Sintaksis

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

Parameter

Argumen

Argumen

Deskripsi

<itemspec>

Diperlukan. Menentukan item yang akan dibandingkan. Jika tidak ada versi atau jalur yang ditentukan, versi ruang kerja saat ini diasumsikan. Menerima jalur server lokal dan Azure DevOps.

Untuk informasi selengkapnya tentang cara TFVC mengurai itemspec untuk menentukan item mana yang berada dalam cakupan, lihat Menggunakan perintah kontrol versi Team Foundation.

Perintah difference tidak mendukung karakter kartubebas.

Parameter ini tidak dapat dikombinasikan dengan opsi /shelveset.

<itemspec2>

Fakultatif. Item tempat itemspec akan dibandingkan. Jika Anda tidak menyediakan itemspeckedua, versi server Azure DevOps terbaru dari item digunakan.

<filetype>

Menyediakan nilai untuk opsi /type. Anda dapat menentukan binary atau text dan nomor halaman kode atau nama yang mudah diingat untuk halaman kode.

<format>

Digunakan dengan opsi /format untuk menentukan format output dari salah satu jenis berikut:

• Visual
• Brief
• Context
• RCS
• SS
• SS_SideBySide
• SS_Unix
• Unified
• Unix

Format output ini dijelaskan di bagian Keterangan .

<versionspec>

Nilai yang disediakan pengguna untuk opsi /version. Untuk informasi selengkapnya tentang cara TFVC mengurai spesifikasi versi untuk menentukan item mana yang berada dalam cakupannya, lihat Menggunakan perintah kontrol versi Team Foundation.

<shelvesetowner>

Mengidentifikasi pemilik shelveset berdasarkan nama pengguna. Jika nilai untuk parameter ini tidak disediakan, pengguna saat ini diasumsikan.

<shelvesetname>

Menentukan nama shelveset. Anda dapat membuat lebih dari satu shelveset dengan nama yang sama di server yang menjalankan TFVC selama pengguna yang berbeda memiliki setiap shelveset.

<shelveset_itemspec>

Menentukan nama folder atau file di shelveset untuk dibandingkan dengan versi shelveset dasar.

<username>

Menyediakan nilai untuk opsi /login. Anda dapat menentukan nilai nama pengguna sebagai DOMAIN\username atau username.

Opsi

Opsi

Deskripsi

/type

Mengambil alih pengodean yang terdeteksi dan menggunakan pengodean yang ditentukan untuk menyajikan file ke mesin yang berbeda.

/version

Menentukan versi file atau folder yang akan dibandingkan. Secara default, TFVC menggunakan versi ruang kerja jika Anda tidak menyediakan versionspec.

Alih-alih menggunakan bendera /version, Anda dapat menentukan versi dengan menambahkan titik koma dan penentu versi ke akhir setiap nama file.

/format

Menentukan format output yang ditentukan oleh argumen format.

/ignorespace

Tidak menyoroti perbedaan spasi kosong antara file yang dibandingkan.

/ignoreeol

Mengabaikan perbedaan antara karakter baris baru dalam dua file atau versi file. /ignoreeol bekerja secara berbeda dari ignorespace, yang memperlakukan delapan ruang yang identik dengan satu spasi. Namun, jika Anda menggunakan opsi /ignoreeol dan File A memiliki dua karakter baris baru antara area teks yang tidak berubah, dan File B memilikinya, hasilnya ditampilkan sebagai perbedaan. Jika kedua file hanya memiliki satu baris baru, tetapi File A menggunakan \r\n sebagai baris baru dan File B menggunakan \n, opsi /ignoreeol akan mengabaikannya sebagai perbedaan.

/ignorecase

Tidak menyoroti perbedaan dalam huruf casing antara file yang dibandingkan.

/recursive

Membandingkan perbedaan antara folder saat ini dan semua subfoldernya.

/options

Menentukan string opsi untuk alat yang akan dipanggil oleh difference. Untuk informasi selengkapnya, lihat Mengaitkan jenis file dengan alat perbedaan dan Mengaitkan jenis file dengan alat penggabungan.

/shelveset

Menentukan shelveset untuk dibandingkan dengan versi server Azure DevOps yang menjadi dasar shelveset.

Opsi ini tidak dapat dikombinasikan dengan argumen itemspec. Untuk membandingkan item shelveset individual, Anda dapat menyediakan shelveset_itemspec.

/noprompt

Menyembunyikan kotak dialog apa pun yang akan ditampilkan selama penyelesaian operasi ini.

/configure

Memanggil kotak dialog Mengonfigurasi Alat Pengguna dari antarmuka pengguna Visual Studio. Untuk informasi selengkapnya, lihat Mengaitkan jenis file dengan alat perbedaan.

/login

Menentukan nama pengguna dan kata sandi untuk mengautentikasi pengguna dengan TFVC.

Komentar

Nota

Anda dapat mengetik tf diff atau tf difference pada baris perintah untuk menjalankan perintah ini.

Anda dapat menggunakan perintah difference untuk membandingkan dan jika memungkinkan perbedaan tampilan antara:

• Dua file yang berbeda atau dua versi file yang sama.

• Satu atau beberapa item dalam folder.

• Satu, beberapa, atau semua item di shelveset di server Azure DevOps.

Anda dapat menggunakan perintah difference untuk membandingkan file versi dan non-versi.

TFVC mengategorikan semua file menurut jenis. File teks dapat digabungkan dan dibandingkan, berdampingan dan berbaris demi baris, selama kedua file memiliki pengodean yang sama. Jika Anda ingin membandingkan dua file yang pengodeannya tidak sama, Anda dapat menutupi sementara atau mengambil alih properti pengodean untuk file dengan menggunakan opsi /type.

File biner dapat dibandingkan tetapi tidak dapat digabungkan. Saat Anda meneruskan satu atau beberapa file biner ke perintah difference, TFVC menunjukkan apakah ada perbedaan antara file biner dan item yang sedang dibandingkan. Untuk informasi selengkapnya tentang bagaimana TFVC membedakan antara dan memperlakukan file dari berbagai jenis, lihat Mengelola jenis file.

Jika Anda menentukan dua nama file, dua file tersebut akan dibandingkan. Alih-alih menggunakan bendera /version, Anda dapat menentukan versi dengan menambahkan titik koma dan penentu versi ke akhir setiap nama file.

Jika Anda hanya meneruskan satu itemspec ke perintah perbedaan:

• Jika Anda tidak menyediakan versionspec, versi ruang kerja item Anda saat ini dibandingkan dengan versi ruang kerja dasar, secara default. Misalnya, membandingkan versi header.h saat ini dengan versi di mana header.h didasarkan.

• Jika Anda menyertakan versionspec di itemspecAnda, seperti tf difference header.h;LBeta1, TFVC membandingkan versi tersebut dengan versi ruang kerja Anda saat ini pada disk.

• Jika Anda menentukan rentang versi seperti /version:C1~C4, versi file di dua titik akhir rentang dibandingkan.

Untuk informasi selengkapnya tentang cara menggunakan utilitas baris perintah tf, lihat Menggunakan perintah kontrol versi Team Foundation.

Jenis format output

Parameter format, digunakan dengan opsi /format, menentukan banyak format output yang berbeda. Jenis output berikut tersedia:

• Visual jenis format membuka aplikasi perbedaan eksternal. Secara default, diffmerge.exe diluncurkan.

• Brief format mencetak apakah file yang dibandingkan berbeda.

• format Context menyediakan baris konteks untuk perbedaan dalam file. Format ini berasal dari format output diff -c berbasis UNIX.

• format RCS mirip dengan /format:unix, kecuali baris konteks tidak disediakan. Tidak ada penyerahan khusus untuk akhir penanda baris yang hilang di akhir file yang disediakan.

• SS adalah format output perbedaan default untuk Visual SourceSafe. Untuk informasi selengkapnya, lihat Diff (baris perintah).

• SS_SideBySide adalah format output berdampingan default untuk Visual SourceSafe.

• SS_Unix mirip dengan format output /format:unix, tetapi /format:ss_unix menyertakan baris konteks dan /format:unix tidak.

• format Unified berasal dari format output diff -u berbasis UNIX. /format:context mengulangi baris konteks yang identik antara string perbedaan, tetapi tidak /format:unified.

  format Unified menghasilkan baris unified difference string (@@ ... @@) baru hanya ketika jarak ke string perbedaan berikutnya lebih besar dari jumlah baris konteks.

• jenis output Unix berasal dari format output perintah diff berbasis UNIX.

  Format output Unix dibangun dengan cara berikut:

  <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
  

Contoh

Contoh berikut menampilkan perbedaan antara versi lokal 314.cs dan versi ruang kerja 314.cs yang merupakan versi file yang dicek keluar dari server Azure DevOps.

c:\projects>tf difference 314.cs

Contoh berikut menampilkan semua file yang telah diubah di folder src , tetapi tidak menampilkan file yang telah diubah dalam subfolder src.

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

Contoh berikut menampilkan perbedaan antara set perubahan 3 dan set perubahan 8 dari 1254.cs.

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

Contoh berikut menampilkan perbedaan antara versi 314.cs yang termasuk dalam label release dan versi milik changeset 3200.

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

-atau-

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

Contoh berikut menampilkan perbedaan antara versi e271.cs tempat pengguna bernama Pat dirak di shelveset PeerCodeReview8 dan versi shelveset dasar tempat pengguna mendasarkan perubahannya. Output juga menunjukkan jenis perubahan yang tertunda terhadap e271.cs saat pengguna dirak.

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

Contoh berikut menampilkan perbedaan antara semua file di shelveset PeerCodeReview2 dan versi shelveset dasar file-file tersebut.

c:\projects> tf difference /shelveset:PeerCodeReview2

Artikel terkait

• perintah Penggabungan
• perintah Checkin
• perintah Shelvesets
• Mengelola jenis file
• Membandingkan folder dan file