Linhas de código de estágio no Visual Studio

O suporte ao preparo de linhas, também conhecido como preparo interativo, está disponível no Visual Studio 2022 versão 17.3 e posterior. O preparo de linhas permite preparar partes de alterações em seus arquivos diretamente do editor de código. O preparo de linhas também pode ser útil quando você deseja dividir as alterações entre commits diferentes.

Screenshot of an example of line-staging support in Visual Studio 2022.

A partir do Visual Studio 2022 versão 17.6, você pode usar a opção de focalização para também cancelar o preparo das alterações, linha por linha.

Screenshot of an example of how to unstage changes in Visual Studio 2022.

Suporte à margem de cor

A primeira coisa que você pode observar sobre o suporte ao preparo de linhas é como o editor visualiza as alterações do Git na barra de rolagem e na margem.

Screenshot of the color margins in the Visual Studio 2022 editor.

As cores e anotações facilitam a diferenciação entre alterações salvas e não salvas que você adicionou, excluiu ou modificou.

Screenshot of differentiated and annotated color margin examples in Visual Studio 2022.

Dica

Você pode alterar as cores exibidas pelo Visual Studio para ajudá-lo a gerenciar as alterações. Acesse Ferramentas>Opções>Ambiente>Fontes e Cores e escolha entre as seguintes opções:

  • Acompanhar as adições nos documentos sob o controle do código-fonte
  • Acompanhar as exclusões nos documentos sob o controle do código-fonte
  • Acompanhar as modificações nos documentos sob o controle do código-fonte

Screenshot of the Options dialog box where you can change the colors Visual Studio uses for source control.

Suporte Espiar Diferença

As margens de cor são interativas. Quando você seleciona uma margem de cor, o Visual Studio abre a interface do usuário (UI) Espiar Diferença, na qual você pode exibir suas alterações no editor sem alternar o contexto. A interface do usuário Espiar Diferença resume o número de linhas adicionadas e removidas e facilita a navegação entre as alterações usando as setas para cima e para baixo.

Screenshot of the Peek Difference user interface in Visual Studio as it relates to source control.

Você também pode acessar Espiar Diferença ao clicar com o botão direito do mouse em uma linha que inclui alterações. Um menu de contexto é exibido, onde você pode selecionar Espiar Diferença nele. Ou você pode usar o atalho de teclado Alt+F8.

Screenshot of the right-click context menu in Visual Studio where you can select Peek Difference.

Observação

Se preferir uma exibição de diferença embutida, você poderá usar o controle Configurações no canto superior direito do editor Diff para alternar para o modo Embutido.

Screenshot of the Diff options available from the gear icon, where you can select the 'Inline mode' option.

Dica

Você pode modificar a forma como o Visual Studio interage com as alterações de código na interface do usuário Espiar Diferença, usando a opção Clique para espiar a margem de Ferramentas>Opções>Editor de Texto>Avançado. Screenshot of the 'Click to peek in margin' setting. Por exemplo, você pode alterar a configuração padrão de Clique único para Clicar duas vezes,ou selecionar Nenhum para desativar a interface do usuário Espiar Diferença.

Preparar partes de código

Você pode preparar qualquer parte do código usando a interface do usuário (Interface do usuário) Espiar Diferença. Para fazer isso, passe o mouse sobre a alteração que você deseja preparar e selecione Preparar Alteração. Como alternativa, use o botão Preparar global se desejar preparar todas as alterações feitas em um documento.

Screenshot of the Stage Change option in Visual Studio 2022.

Se preferir uma exibição de diferença de tela inteira, você poderá alternar para o editor Diff. Veja como: selecione o botão Promover para Documento no canto superior direito da interface do usuário Espiar Diferença. Ou você pode usar o atalho de teclado Ctrl+Alt+Home. Todos os recursos que a interface do usuário Espiar Diferença fornece também estão disponíveis no editor Diff.

Screenshot of the Stage Change difference view in Visual Studio 2022.

Fazer Commit das alterações preparadas

Após preparar seu commit revisando e preparando as alterações que deseja incluir, você pode criar seu commit usando a janela Alterações do Git. Em seguida, insira sua mensagem de confirmação e selecione Commit Preparada.

Screenshot of the Git Changes dialog in Visual Studio 2022.