Comando Diferença

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

Visual Studio 2019 | Visual Studio 2022

O comando Controle de Versão do Team Foundation (TFVC) difference compara e, se possível, exibe diferenças entre dois arquivos, arquivos em duas pastas ou um check-in particular e um arquivo local ou de servidor.

Pré-requisitos

Para usar o comando difference, você deve ter a permissão Leitura para todos os itens especificados definida como Permitir. Para saber mais, consulte Permissões padrão do TFVC.

Sintaxe

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

Parâmetros

Argumentos

Opções

Comentários

Você pode usar o comando difference para comparar e, se possível, exibir diferenças entre:

• Dois arquivos diferentes ou duas versões do mesmo arquivo.

• Um ou mais itens em uma pasta.

• Um, alguns ou todos os itens em um check-in particular no servidor do Azure DevOps.

Você pode usar o comando difference para comparar arquivos com versão e sem versão.

O TFVC categoriza todos os arquivos por tipo. Os arquivos de texto podem ser mesclados e comparados, lado a lado e linha por linha, desde que ambos os arquivos tenham a mesma codificação. Se você quiser comparar dois arquivos cujas codificações não são iguais, poderá mascarar ou substituir temporariamente a propriedade de codificação de um arquivo usando a opção /type.

Arquivos binários podem ser comparados, mas não podem ser mesclados. Quando você passa um ou mais arquivos binários para o comando difference, o TFVC indica se existem diferenças entre ele e o item ao qual ele está sendo comparado. Para obter mais informações sobre como o TFVC diferencia e trata arquivos de diferentes tipos, consulte Gerenciando tipos de arquivo.

Se você especificar dois nomes de arquivo, os dois arquivos serão comparados. Em vez de usar o sinalizador /versão, você pode especificar versões acrescentando um ponto e vírgula e um especificador de versão ao final de cada nome de arquivo.

Se você passar apenas um itemspec para o comando Diferença:

• Se você não fornecer um versionspec, sua versão atual do espaço de trabalho do item será comparada com a versão base do espaço de trabalho, por padrão. Por exemplo, tf difference header.h compara a versão atual do header.h com a versão na qual header.h se baseia.

• Se você incluir um versionspec em seu itemspec, como tf difference header.h;LBeta1, o TFVC comparará essa versão com a versão atual do espaço de trabalho no disco.

• Se você especificar um intervalo de versões como /version:C1~C4, as versões do arquivo nos dois pontos de extremidade do intervalo serão comparadas.

Para saber mais sobre como usar o utilitário de linha de comando tf, consulte Usar comandos do controle de versão do Team Foundation.

Tipos de formato de saída

O parâmetro format, usado com a opção /format, especifica muitos formatos de saída diferentes. Os seguintes tipos de saída estão disponíveis:

• Visual O tipo de formato abre um aplicativo de diferença externa. Por padrão, diffmerge.exe é iniciado.

• Brief O formato imprime se os arquivos que estão sendo comparados se diferem.

• Context O formato fornece linhas de contexto para as diferenças nos arquivos. Esse formato é derivado do formato de saída diff -c baseado em UNIX.

• RCS O formato é semelhante a /format:unix, exceto que as linhas de contexto não são fornecidas. Nenhuma entrega especial para um marcador de fim de linha ausente no final do arquivo é fornecida.

• SSé o formato de saída de diferença padrão para Visual SourceSafe. Para obter mais informações, consulte Diff (linha de comando).

• SS_SideBySide é o formato de saída lado a lado padrão do Visual SourceSafe.

• SS_Unix é semelhante ao formato de saída /format:unix, mas /format:ss_unix inclui linhas de contexto e /format:unix não.

• Unified formato é derivado do formato de saída diff -u baseado em UNIX. /format:context repete linhas de contexto idênticas entre as cadeias de caracteres de diferença, mas /format:unified não.

  Unified O formato produz uma nova linha de cadeia de caracteres de diferença unificada (@@ ... @@) somente quando a distância para a próxima cadeia de caracteres de diferença é maior que o número de linhas de contexto.

• Unix O tipo de saída é derivado do formato de saída de comando diff baseado em UNIX.

  O Unix formato de saída é construído da seguinte maneira:

  <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
  

Exemplos

O exemplo a seguir exibe as diferenças entre a versão local do 314.cs e a versão do espaço de trabalho do 314.cs que é a versão do arquivo que foi verificada no servidor do Azure DevOps.

c:\projects>tf difference 314.cs

O exemplo a seguir exibe todos os arquivos que foram alterados na pasta src , mas não exibe arquivos que foram alterados em subpastas de src.

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

O exemplo a seguir exibe as diferenças entre o conjunto de alterações 3 e o conjunto de alterações 8 de 1254.cs.

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

Os exemplos a seguir exibem as diferenças entre a versão do 314.cs que pertence à etiqueta release e a versão que pertence ao conjunto de alterações 3200.

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

-ou-

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

O exemplo a seguir exibe a diferença entre as versões do e271.cs em que um usuário chamado Pat fez um check-in particular PeerCodeReview8 e a versão base do check-in particular em que baseou suas alterações. A saída também mostra os tipos de alterações pendentes de e271.cs quando o usuário tiver feito check-in particular.

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

O exemplo a seguir exibe as diferenças entre todos os arquivos no PeerCodeReview2 check-in particular e a versão base do check-in particular desses arquivos.

c:\projects> tf difference /shelveset:PeerCodeReview2

Artigos relacionados

• Comando merge
• Comando Check-in
• Comando Shelvesets
• Gerenciar tipos de arquivo
• Comparar pastas e arquivos