Megosztás:

Különbség parancs

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

Visual Studio 2019 | Visual Studio 2022

A Team Foundation verziókövetés (TFVC) difference parancs összehasonlítja és lehetőség szerint megjeleníti a két fájl, a két mappában lévő fájlok, illetve egy polckészlet és egy helyi vagy egy kiszolgálófájl közötti különbségeket.

Előfeltételek

Kategória Requirements
Permissions Olvasási engedély az összes megadott, Engedélyezés értékre beállított elemhez.

További információ: Alapértelmezett TFVC-engedélyek.

Szintaxis

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

Paraméterek

Érvek

argumentum

leírási

<itemspec>

Szükséges. Megadja az összehasonlítandó elemet. Ha nincs megadva verzió vagy elérési út, a rendszer feltételezi a munkaterület aktuális verzióját. Fogadja a helyi és az Azure DevOps-kiszolgáló elérési útját is.

További információ arról, hogy a TFVC hogyan elemzi a itemspec annak meghatározásához, hogy mely elemek tartoznak a hatókörbe: A Team Foundation verziókövetési parancsainak használata.

A difference parancs nem támogatja a helyettesítő karaktereket.

Ez a paraméter nem kombinálható a /shelveset beállítással.

<itemspec2>

Szabadon választható. Az az elem, amelyhez a itemspec össze kell hasonlítani. Ha nem ad meg második itemspec, a rendszer az elem legújabb Azure DevOps-kiszolgálóverzióját használja.

<filetype>

A /type beállítás értékét adja meg. Megadhat binary vagy text, valamint egy kódlapszámot vagy egy kódlap rövid nevét.

<format>

A /format beállítással a következő típusok egyikének kimeneti formátumát adhatja meg:

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

Ezeket a kimeneti formátumokat a Megjegyzések szakaszban ismertetjük.

<versionspec>

A /version beállítás felhasználó által megadott értéke. További információ arról, hogy a TFVC hogyan elemzi a verzióspecifikációt annak meghatározásához, hogy mely elemek tartoznak a hatókörébe, olvassa el A Team Foundation verziókövetési parancsainak használata.

<shelvesetowner>

A polckészlet tulajdonosát felhasználónév alapján azonosítja. Ha nincs megadva érték ehhez a paraméterhez, a rendszer az aktuális felhasználót feltételezi.

<shelvesetname>

Egy polckészlet nevét adja meg. Több polckészletet is létrehozhat ugyanazzal a névvel a TFVC-t futtató kiszolgálón, ha minden egyes polckészletet egy másik felhasználó birtokol.

<shelveset_itemspec>

Egy mappa vagy fájl nevét adja meg a polckészletben, amely összehasonlítható az alap polckészlet verziójával.

<username>

Értéket ad a /login beállításnak. Megadhatja a felhasználónév értékét DOMAIN\username vagy username.

Beállítások

option

leírási

/type

Felülírja az észlelt kódolásokat, és a megadott kódolással jeleníti meg a fájlokat a különbségi motornak.

/version

Megadja az összehasonlítandó fájl vagy mappa verzióját. Alapértelmezés szerint a TFVC a munkaterület verzióját használja, ha nem ad meg versionspec.

A /version jelző használata helyett a fájlnevek végéhez pontosvesszővel és verziójelölővel adhat meg verziókat.

/format

A format argumentum által megadott kimeneti formátumot adja meg.

/ignorespace

Nem emeli ki az összehasonlított fájlok közötti térbeli különbségeket.

/ignoreeol

Figyelmen kívül hagyja a két fájlban vagy fájlverzióban lévő új sorkarakterek közötti különbségeket. /ignoreeol másképp működik, mint ignorespace, amely nyolc szóközt azonosan kezel. Ha azonban a /ignoreeol beállítást használja, és A fájl két új sor karaktert tartalmaz a szöveg változatlan területei között, és B fájl van, az eredmény különbségként jelenik meg. Ha mindkét fájlnak csak egy új sora van, de A fájl\r\n használ új sorként, és B fájl\nhasznál, a /ignoreeol beállítás ezt figyelmen kívül hagyja.

/ignorecase

Nem emeli ki a betűház különbségeit az összehasonlított fájlok között.

/recursive

Összehasonlítja az aktuális mappa és az összes almappája közötti különbségeket.

/options

A differenceáltal meghívandó eszköz beállítási sztringjének megadása. További információ: Fájltípus társítása egy különbségeszközhöz és Fájltípus társítása egyesítési eszközzel.

/shelveset

Egy polckészletet határoz meg, amely összehasonlítható az Azure DevOps-kiszolgáló azon verziójával, amelyen a polckészlet alapul.

Ez a beállítás nem kombinálható itemspec argumentummal. Az egyes polckészletelemek összehasonlításához megadhat egy shelveset_itemspec.

/noprompt

Letiltja azokat a párbeszédpaneleket, amelyek egyébként megjelennek a művelet végrehajtása során.

/configure

Meghívja a Felhasználói eszközök konfigurálása párbeszédpanelt a Visual Studio felhasználói felületéről. További információ: Fájltípus társítása egy különbségeszközhöz.

/login

Megadja a felhasználó TFVC-vel való hitelesítéséhez megadott felhasználónevet és jelszót.

Megjegyzések

Jegyzet

A parancs futtatásához beírhat tf diff vagy tf difference a parancssorba.

A difference paranccsal összehasonlíthatja és lehetőség szerint megjelenítheti a különbségeket a következők között:

  • Két különböző fájl vagy ugyanazon fájl két verziója.

  • Egy vagy több elem egy mappában.

  • Az Azure DevOps-kiszolgálón található polckészlet egy, néhány vagy összes eleme.

A difference paranccsal összehasonlíthatja a verziószámozott és a nem verziószámozott fájlokat is.

A TFVC típus szerint kategorizálja az összes fájlt. A szövegfájlok egyesíthetők és összehasonlíthatók egymás mellett és sorbanként, mindaddig, amíg mindkét fájl azonos kódolással rendelkezik. Ha két olyan fájlt szeretne összehasonlítani, amelyek kódolása nem azonos, ideiglenesen maszkolhatja vagy felülbírálhatja egy fájl kódolási tulajdonságát a /type beállítással.

A bináris fájlok összehasonlíthatók, de nem egyesíthetők. Ha egy vagy több bináris fájlt ad át a difference parancsnak, a TFVC jelzi, hogy léteznek-e különbségek a fájl és az elem között, amelyhez az összehasonlítás történik. További információ arról, hogy a TFVC hogyan különbözteti meg és kezeli a különböző típusú fájlokat: Fájltípusok kezelése.

Ha két fájlnevet ad meg, a rendszer összehasonlítja a két fájlt. A /version jelző használata helyett a fájlnevek végéhez pontosvesszővel és verziójelölővel adhat meg verziókat.

Ha csak egy itemspec ad át a különbség parancsnak:

  • Ha nem ad meg versionspec, az elem aktuális munkaterületi verziója alapértelmezés szerint az alap munkaterület verziójával lesz összehasonlítva. tf difference header.h például a header.h aktuális verzióját hasonlítja össze azzal a verzióval, amelyen header.h alapul.

  • Ha egy versionspec szerepel a itemspec(például tf difference header.h;LBeta1), a TFVC összehasonlítja ezt a verziót a lemez aktuális munkaterületi verziójával.

  • Ha olyan verziótartományt ad meg, mint például a /version:C1~C4, a rendszer összehasonlítja a tartomány két végpontján található fájlverziókat.

A tf parancssori segédprogram használatáról további információt a A Team Foundation verziókövetési parancsainak használatacímű témakörben talál.

Kimeneti formátumtípusok

A format beállítással használt /format paraméter számos különböző kimeneti formátumot határoz meg. A következő kimeneti típusok érhetők el:

  • Visual formátumtípus egy külső különbségalkalmazást nyit meg. Alapértelmezés szerint a diffmerge.exe indul el.

  • Brief formátum azt jelzi, hogy az összehasonlítandó fájlok eltérnek-e egymástól.

  • Context formátum kontextust biztosít a fájlok közötti különbségekhez. Ez a formátum a UNIX-alapú diff -c kimeneti formátumból származik.

  • RCS formátum hasonló a /format:unixformátumhoz, kivéve a környezeti sorokat. Nincs speciális átadás a fájl végén található sorvégjelölőhöz.

  • SS a Visual SourceSafe alapértelmezett kimeneti formátuma. További információ: Diff (parancssor).

  • SS_SideBySide a Visual SourceSafe alapértelmezett egymás melletti kimeneti formátuma.

  • SS_Unix hasonló a /format:unix kimeneti formátumhoz, de /format:ss_unix környezeti sorokat tartalmaz, és /format:unix nem.

  • Unified formátum a UNIX-alapú diff -u kimeneti formátumból származik. /format:context azonos környezeti vonalakat ismétel meg a különbségi sztringek között, de /format:unified nem.

    Unified formátum csak akkor hoz létre új egyesített különbségi sztringet (@@ ... @@) , ha a következő különbségi sztring távolsága nagyobb, mint a környezeti vonalak száma.

  • Unix kimeneti típus UNIX-alapú diff parancs kimeneti formátumából származik.

    A Unix kimeneti formátum a következő módon jön létre:

    <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

Példák

Az alábbi példa a 314.cs helyi verziója és a 314.cs munkaterületi verziója közötti különbségeket mutatja be, amely az Azure DevOps-kiszolgálóról kivett fájl verziója.

c:\projects>tf difference 314.cs

Az alábbi példa az src mappában módosított összes fájlt megjeleníti, de nem jeleníti meg a srcalmappáiban módosított fájlokat.

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

Az alábbi példa a 1254.cs3. és 8. módosítási halmaza közötti különbségeket mutatja be.

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

Az alábbi példák a 314.cs azon verziója közötti különbségeket mutatják be, amelyek a release címkéhez tartoznak, és a 3200-at érintő változáskészlethez tartozó verzió között.

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

-vagy-

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

Az alábbi példa a e271.cs azon verziói közötti különbséget mutatja be, amelyek alapján egy Pat nevű felhasználó a polckészletben PeerCodeReview8 és az alap polckészlet azon verziója között, amelyekre a módosításokat alapozta. A kimenet azt is megjeleníti, hogy milyen típusú módosítások várnak a e271.cs a felhasználó polcra való felállításakor.

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

Az alábbi példa a PeerCodeReview2 polckészletben lévő összes fájl és a fájlok alap polckészletének verziója közötti különbségeket mutatja be.

c:\projects> tf difference /shelveset:PeerCodeReview2
  • Last updated on