Localizar alterações de código e outro histórico com o CodeLens

O Visual Studio CodeLens ajuda você a manter o foco em seu trabalho enquanto descobre o que aconteceu com seu código – tudo isso sem sair do editor de código do IDE (Ambiente de Desenvolvimento Interativo). Você pode encontrar referências a um código, alterações no código, bugs vinculados, itens de trabalho do Azure DevOps, revisões de código e testes de unidade.

O CodeLens pode mostrar onde e como as partes individuais do código são usadas em sua solução:

Exiba detalhes sobre as alterações de código do usuário e use o clique com o botão direito do mouse Enviar email para <usuário> opção para contatar os usuários sem sair do editor de código:

Para escolher os indicadores que você deseja ver ou desativar e ativar o CodeLens, acesse Tools>Options>Text Editor>All Languages>CodeLens.

Atalhos de teclado no Visual Studio 2022

Muitas das operações descritas nas seções a seguir estão disponíveis usando atalhos de teclado na janela do editor de código do Visual Studio.

Para usar o teclado para selecionar indicadores, selecione e segure a tecla Alt para exibir as teclas de número relacionadas e selecione o número no teclado que corresponde ao indicador desejado:

Localizar referências ao seu código

Você pode encontrar referências em código C# ou Visual Basic.

1. No editor de código, selecione o indicador de referências ou use o atalho de teclado Alt+2:

   

   Nota

   Se o indicador mostrar 0 referências, isso indicará que você não tem nenhuma referência do código C# ou Visual Basic. No entanto, pode haver referências em outros itens do projeto, como arquivos .xaml e .aspx.

2. Para exibir o código de referência, passe o mouse sobre a referência na lista.

   

3. Para abrir o arquivo que contém a referência, clique duas vezes na referência.

Criar um mapa de código

Para ver as relações entre o código e suas referências, você pode criar um mapa de código. Na barra de ferramentas Mapa de Código, expanda o menu suspenso Mostrar Relacionados e selecione Localizar Todas as Referências:

Localizar alterações em seu código

Inspecione o histórico do código para descobrir o que aconteceu com seu código. Ou examine as alterações antes que elas sejam mescladas em seu código para que você possa entender melhor como as alterações em outras ramificações podem afetar seu código.

Você precisa:

• Visual Studio Enterprise ou Visual Studio Professional

• Git ou Azure DevOps Server (antigo Team Foundation Server) ou TFVC (Controle de Versão do Team Foundation)

Para o código C# (.cs) ou Visual Basic (.vb) armazenado com TFVC ou Git, os detalhes do CodeLens são visíveis nos níveis de classe e método (indicadores de no nível do elemento de código) dentro do arquivo:

Para tipos de arquivo diferentes de .cs ou .vb, a opção Mostrar indicador Codelens no nível do arquivo permite exibir detalhes do CodeLens para todo o arquivo. Os indicadores de nível de arquivo são exibidos na parte inferior do arquivo no editor de código.

Indicadores de nível de elemento de código

Indicadores de nível de elemento de código permitem ver quem alterou seu código e quais alterações eles fizeram. Indicadores de nível de elemento de código estão disponíveis para código C# e Visual Basic.

Você também pode exibir o histórico de alterações ao usar o TFVC ou o Azure DevOps Services:

O período de tempo padrão é os últimos 12 meses (um ano).

Para ver um histórico detalhado de todas as alterações, incluindo essas alterações de mais de um ano atrás, selecione Mostrar todas as alterações de arquivo, que abre uma janela Histórico. Na janela Histórico, você pode visualizar todos os seus arquivos que estão em um repositório Git e selecionar o indicador de alterações no nível do elemento de código para obter mais detalhes.

Indicadores no nível do arquivo

Você também pode encontrar alterações para um arquivo inteiro com indicadores de nível de arquivo na parte inferior da janela no editor de código.

Para obter mais detalhes sobre uma alteração, clique com o botão direito do mouse no item. Dependendo se você estiver usando TFVC ou Git, há opções para comparar as versões do arquivo, exibir detalhes e acompanhar o conjunto de alterações, obter a versão selecionada do arquivo e enviar por email o autor dessa alteração. Alguns dos detalhes aparecem no Team Explorer quando ativado; caso contrário, os detalhes aparecem no painel Alterações do Git. Você também pode ver os detalhes na barra de rolagem horizontal na parte inferior do editor de código.

Os indicadores mostram quem alterou seu código ao longo do tempo, o que pode ajudá-lo a encontrar padrões nas alterações da equipe e avaliar seu impacto:

A partir do Visual Studio 2022 versão 17.12 Versão Prévia 2, você pode mostrar ou ocultar indicadores no nível do arquivo na barra de rolagem horizontal do editor de código com a opção Ferramentas > Opções > Editor de Texto > Avançado>Mostrar indicador do CodeLens no nível do arquivo. Essa opção atualiza a visibilidade dos tipos de arquivo que implementam o controle CodeLens no nível do arquivo na barra de rolagem do editor inferior, como XAML, HTML e CSS. A opção não afeta arquivos que contêm CodeLens embutidos (C# e VB).

Encontrar alterações no seu ramo atual

Sua equipe pode ter vários branches, como um branch principal e um branch de desenvolvimento filho, para reduzir o risco de interrupção de código estável.

Você pode descobrir quantos colaboradores alteraram seu código e quantas alterações foram feitas no branch principal selecionando o atalho de teclado Alt+0

Descubra quando o código foi ramificado

Para saber quando o código foi ramificado, navegue para o código no branch filho. Em seguida, selecione o indicador de alterações (ou selecione Alt+0):

Descubra alterações recebidas de outras ramificações

Você pode exibir as alterações recebidas e não precisa sair do branch atual para examinar uma alteração.

Localizar quando as alterações foram mescladas

Você pode ver quando as alterações foram mescladas, para que você possa determinar quais alterações estão incluídas em sua ramificação.

Compare uma modificação recebida com sua versão local

Para comparar uma alteração de entrada com a versão local, clique duas vezes no conjunto de alterações ou selecione Shift + F10.

Ícones de ramificação

O ícone na coluna Branch indica como o branch está relacionado ao branch no qual você está trabalhando.

Ícone	A alteração foi proveniente de
	A ramificação atual
	O ramo pai
	Uma ramificação filha
	Uma ramificação par
	Um ramo mais afastado do que um elemento próximo como um pai, filho ou colega.
	Uma mesclagem da ramificação pai para uma ramificação filha
	Uma mesclagem de uma ramificação filha para a ramificação pai
	Uma mesclagem de uma ramificação não relacionada (mesclagem sem base)

Itens de trabalho vinculados

Localize itens de trabalho vinculados selecionando os itens de trabalho indicador ou use o Alt+8 atalho de teclado.

Revisões de código vinculadas

Encontre revisões de código vinculadas selecionando o indicador de revisões. Para usar o teclado, mantenha pressionada a tecla Alt e selecione seta para a esquerda ou seta para a direita para procurar as opções do indicador.

Bugs vinculados

Encontre bugs vinculados selecionando o indicador de bugs ou use a tecla de atalho Alt + 7.

Contate o proprietário de um item

Localize o autor de um item selecionando o indicador de autores ou use o Alt + 5 atalho de teclado.

Você também pode abrir o menu de atalho de um item para ver as opções de contato. (Se você tiver o Teams instalado, você terá outras opções de comunicação disponíveis para você.)

Testes de unidade associados

Você pode descobrir testes de unidade existentes para seu código C# ou Visual Basic sem abrir do Gerenciador de Testes.

1. Acesse um código do aplicativo com o código de teste de unidade associado.

2. Conforme necessário, crie seu aplicativo para carregar os indicadores de teste do CodeLens.

3. Examine os testes para o código usando o atalho de teclado Alt + 3.

4. Se você vir o ícone Aviso, os testes ainda não foram executados; portanto, execute-os.

5. Para examinar a definição de um teste, clique duas vezes no item de teste na janela indicador do CodeLens e abra o arquivo de código no editor.

6. Para examinar os resultados do teste, escolha o status do teste Falha ou Aprovado ( ou ) ou use o atalho de teclado Alt+1.

7. Para ver quantos colaboradores alteraram esse teste, quem o alterou ou quantas alterações foram feitas, encontre o histórico do código e os itens associados.

Perguntas e respostas

P: Como desativar ou ativar o CodeLens ou escolher quais indicadores ver?

A: Você pode desativar ou ativar indicadores, exceto pelo indicador de referências. Vá para Ferramentas>Opções>Editor de Texto>Todos os Idiomas>CodeLens.

Quando os indicadores são ativados, você também pode abrir as opções do CodeLens dos indicadores. Além disso, você pode ativar e desativar indicadores de nível de arquivo CodeLens usando os ícones de divisa na parte inferior da janela do editor.

P: Onde está o CodeLens?

R: o CodeLens é exibido no código C# e Visual Basic no nível de método, classe, indexador e propriedade. O CodeLens aparece no nível do arquivo para todos os outros tipos de arquivos.

• Verifique se o CodeLens está ativado. Vá para Ferramentas>Opções>Editor de Texto>Todos os Idiomas>CodeLens.

• Os indicadores relacionados ao Azure DevOps aparecem somente quando os itens de trabalho são vinculados ao código e quando você tem permissões para abrir itens de trabalho vinculados. Confirme que você tem permissões de membro da equipe .

• Indicadores de teste de unidade não aparecem quando o código do aplicativo não tem testes de unidade. Os indicadores de status de teste são exibidos automaticamente em projetos de teste. Se você sabe que o código do seu aplicativo possui testes de unidade, mas os indicadores de teste não aparecem, tente compilar a solução (Ctrl + Shift + B).

P: Por que eu não vejo os detalhes de item de trabalho para uma confirmação?

R: Esse cenário pode acontecer porque o CodeLens não consegue encontrar os itens de trabalho nos Quadros do Azure. Verifique se você está conectado ao projeto que tem esses itens de trabalho e se você tem permissões para ver esses itens de trabalho. Os detalhes do item de trabalho também podem não ser exibidos se a descrição de commit contiver informações incorretas sobre as IDs dos itens de trabalho no Azure Boards.

P: Como posso alterar a fonte e a cor do CodeLens?

R: Acesse Ferramentas>Opções>Ambiente>Fontes e Cores.

Para usar o teclado:

1. Selecione Alt + T + O para abrir a caixa de diálogo Opções.

2. Selecione a Seta para cima ou Seta para baixo para acessar o nó Ambiente. Em seguida, selecione a Seta para a esquerda para expandir o nó.

3. Selecione a Seta para baixo para acessar Fontes e Cores.

4. Selecione a Guia para acessar a lista Mostrar configurações para e, em seguida, selecione a Seta para baixo para selecionar CodeLens.

P: Posso mover a exibição de cabeçalho do CodeLens?

R: Sim, escolha o ícone Encaixar para encaixar o CodeLens como uma janela.

P: Como atualizar os indicadores?

R: O processo de atualização é diferente dependendo do indicador:

• Referências: este indicador é atualizado automaticamente quando o código é alterado. Se o indicador de referências estiver encaixado como uma janela separada, atualize o indicador selecionando Atualizar.

• Equipe: atualize esses indicadores selecionando Atualizar Indicadores da Equipe CodeLens no menu de clique com o botão direito.

• Teste: encontre os testes de unidade do código para atualizar o indicador de Teste.

P: O que é "Versão Local"?

R: A seta Versão local aponta para o conjunto de alterações mais recente na versão local de um arquivo. Quando o servidor tem conjuntos de alterações mais recentes, eles aparecem antes ou depois da seta da versão local , dependendo da ordem usada para ordenar as alterações.

P: Meus indicadores de teste do CodeLens não aparecem mais no meu arquivo quando abro minha solução pela primeira vez. Como posso carregá-los?

R: Recompile seu projeto para obter os indicadores de teste do CodeLens para carregar no seu arquivo. Para melhorar o desempenho, o Visual Studio não busca mais informações de origem para indicadores de teste quando arquivos de código são carregados. Os indicadores de teste são carregados após uma compilação ou quando você navega para um teste clicando duas vezes nele no Gerenciador de Testes .

Conteúdo relacionado

• Sobre o controle de versão do Git no Visual Studio
• Recursos do Editor de Código

O Visual Studio CodeLens ajuda você a manter o foco em seu trabalho enquanto descobre o que aconteceu com seu código – tudo isso sem sair do editor de código do IDE (Ambiente de Desenvolvimento Interativo). Você pode encontrar referências a um código, alterações no código, bugs vinculados, revisões de código e testes de unidade.

O CodeLens pode mostrar onde e como as partes individuais do código são usadas em sua solução.

Contate sua equipe sobre alterações no código sem sair do editor:

Para escolher os indicadores que você deseja ver ou desativar e ativar o CodeLens, acesse Tools>Options>Text Editor>All Languages>CodeLens.

Atalhos de teclado no Visual Studio 2019

Muitas das operações descritas nas seções a seguir estão disponíveis usando atalhos de teclado na janela do editor de código do Visual Studio.

Para usar o teclado para selecionar indicadores, selecione e segure a tecla Alt para exibir as teclas de número relacionadas e selecione o número no teclado que corresponde ao indicador desejado:

Localizar referências ao código no Visual Studio

Você pode encontrar referências em código C# ou Visual Basic.

1. No editor de código, selecione as referências aos indicadores ou use o atalho de teclado Alt + 2:

   

   Nota

   Se o indicador mostrar 0 referências, isso indicará que você não tem nenhuma referência do código C# ou Visual Basic. No entanto, pode haver referências em outros itens de projeto, como os arquivos .xaml e os arquivos .aspx.

2. Para exibir o código de referência, passe o mouse sobre a referência na lista.

   

3. Para abrir o arquivo que contém a referência, clique duas vezes na referência.

Mapas de código

Para ver as relações entre o código e suas referências, criar um mapa de código. No menu de atalho do mapa de código, selecione Mostrar Todas as Referências.

Localizar alterações em seu código

Inspecione o histórico do código para descobrir o que aconteceu com seu código. Ou examine as alterações antes que elas sejam mescladas em seu código para que você possa entender melhor como as alterações em outras ramificações podem afetar seu código.

Você precisa:

• Visual Studio Enterprise ou Visual Studio Professional

• Git ou Azure DevOps Server (anteriormente Team Foundation Server) ou Controle de Versão do Team Foundation (TFVC)

Para o código do C# ou Visual Basic armazenado com o TFVC ou Git, você obtém detalhes do CodeLens nos níveis de classe e de método (indicadores no nível do elemento de código).

Para arquivo de tipos diferentes de .cs ou .vb, obtenha detalhes do CodeLens do arquivo inteiro em um só lugar na parte inferior da janela (indicadores no nível do arquivo):

Indicadores de nível de elemento de código

Indicadores de nível de elemento de código permitem ver quem alterou seu código e quais alterações eles fizeram. Indicadores de nível de elemento de código estão disponíveis para código C# e Visual Basic.

Você também pode exibir o histórico de alterações ao usar o TFVC ou o Azure DevOps Services:

O período de tempo padrão é os últimos 12 meses (um ano).

Para ver um histórico detalhado de todas as alterações, incluindo essas alterações de mais de um ano atrás, selecione Mostrar todas as alterações de arquivo:

A janela Histórico é exibida:

Quando os arquivos estão em um repositório Git e você escolhe o indicador de alterações no nível do elemento de código, a janela Histórico mostra os detalhes das confirmações do repositório:

Indicadores no nível do arquivo

Encontre alterações para um arquivo inteiro com indicadores de nível de arquivo na parte inferior da janela no editor de código:

Para obter mais detalhes sobre uma alteração, clique com o botão direito do mouse no item. Dependendo se você estiver usando TFVC ou Git, há opções para comparar as versões do arquivo, exibir detalhes e acompanhar o conjunto de alterações, obter a versão selecionada do arquivo e enviar por email o autor da alteração. Alguns dos detalhes aparecem no Team Explorer no Visual Studio 2019 versão 16.7 e anteriores. No Visual Studio 2019 versão 16.8 e posteriores, os detalhes aparecem no painel Git Changes .

Os indicadores mostram quem alterou seu código ao longo do tempo, o que pode ajudá-lo a encontrar padrões nas alterações da equipe e avaliar seu impacto.

Encontre alterações na sua ramificação atual

Sua equipe pode ter vários branches, como um branch principal e um branch de desenvolvimento filho, para reduzir o risco de interrupção de código estável.

Você pode descobrir quantos colaboradores alteraram seu código e quantas alterações foram feitas no branch principal pressionando Alt+6:

Descubra quando o código foi ramificado

Para saber quando o código foi ramificado, navegue para o código no branch filho. Em seguida, selecione o indicador de alterações (ou pressione Alt+6):

Descubra alterações recebidas de outras ramificações

Você pode visualizar alterações recebidas. Na captura de tela a seguir, uma correção de bug foi feita no branch dev:

Examine a alteração sem sair do branch atual (main):

Localizar quando as alterações foram mescladas

Você pode ver quando as alterações foram mescladas, para que possa determinar quais alterações estão incluídas no seu ramo:

Por exemplo, agora o código no branch main tem a correção de bug do branch dev:

Comparar a alteração de entrada com a versão local

Compare uma mudança recebida com sua versão local selecionando Shift+F10ou dando um duplo clique no conjunto de alterações.

Ícones de ramificação

O ícone na coluna Branch indica como o branch está relacionado ao branch no qual você está trabalhando.

Ícone	A alteração foi proveniente de
	A ramificação atual
	A ramificação pai
	Uma ramificação filha
	Uma ramificação par
	Uma ramificação mais distante que uma pai, filha ou par
	Uma mesclagem da ramificação pai para uma ramificação filha
	Uma mesclagem de uma ramificação filha para a ramificação pai
	Uma mesclagem de uma ramificação não relacionada (mesclagem sem base)

Itens de trabalho vinculados no Visual Studio 2019

Localize itens de trabalho vinculados selecionando os itens de trabalho indicador ou use o atalho de teclado Alt+8:

Revisões de código vinculado no Visual Studio 2019

Encontre revisões de código vinculadas selecionando o indicador de revisões. Para usar o teclado, segure a tecla Alt e selecione o seta para a esquerda ou seta para a direita para procurar as opções de indicador.

Bugs vinculados no Visual Studio 2019

Encontre bugs vinculados selecionando o indicador de bugs ou use o atalho de teclado Alt+7:

Contate o proprietário de um item no Visual Studio 2019

Localize o autor de um item selecionando o indicador de autores ou use o Alt+5 atalho de teclado:

Abra o menu de atalho de um item para ver as opções de contato. Se você tiver o Teams instalado, poderá ver opções semelhantes à seguinte captura de tela:

Testes de unidade associados no Visual Studio 2019

Você pode descobrir testes de unidade existentes para seu código C# ou Visual Basic sem abrir do Gerenciador de Testes.

1. Acesse um código do aplicativo com o código de teste de unidade associado.

2. Conforme necessário, crie seu aplicativo para carregar os indicadores de teste do CodeLens.

3. Examine os testes do código selecionando o atalho de teclado do Alt+3:

   

4. Se você vir o ícone Aviso, os testes ainda não foram executados; portanto, execute-os.

   

5. Para examinar a definição de um teste, clique duas vezes no item de teste na janela indicador do CodeLens e abra o arquivo de código no editor:

   

6. Para examinar os resultados do teste, escolha o status do teste Falhou ou o indicador de Aprovado ( ou ) ou use o atalho de teclado Alt + 1:

   

7. Para ver quantos colaboradores modificaram o teste, quem modificou este teste ou quantas alterações foram feitas neste teste, encontre o histórico do código e itens vinculados.

Perguntas e respostas sobre o CodeLens no Visual Studio 2019

P: Como desativar ou ativar o CodeLens ou escolher quais indicadores ver?

A: Você pode desativar ou ativar indicadores, exceto pelo indicador de referências. Vá para Ferramentas>Opções>Editor de Texto>Todos os Idiomas>CodeLens.

Quando os indicadores são ativados, você também pode abrir as opções do CodeLens dos indicadores.

Ative e desative os indicadores de nível de arquivo do CodeLens usando os ícones de divisa na parte inferior da janela do editor.

P: Onde está o CodeLens?

R: o CodeLens é exibido no código C# e Visual Basic no nível de método, classe, indexador e propriedade. O CodeLens aparece no nível do arquivo para todos os outros tipos de arquivos.

• Verifique se o CodeLens está ativado. Vá para Ferramentas>Opções>Editor de texto>Todos os idiomas>CodeLens.

• Indicadores relacionados ao DevOps aparecem somente quando os itens de trabalho são vinculados ao código e quando você tem permissões para abrir itens de trabalho vinculados. Confirme que você tem as permissões de membro da equipe .

• Indicadores de teste de unidade não aparecem quando o código do aplicativo não tem testes de unidade. Os indicadores de status de teste são exibidos automaticamente em projetos de teste. Se você sabe que o código do aplicativo tem testes de unidade, mas os indicadores de teste não aparecem, tente compilar a solução (Ctrl+Shift+B).

P: Por que eu não vejo os detalhes de item de trabalho para uma confirmação?

R: Esse cenário pode acontecer porque o CodeLens não consegue encontrar os itens de trabalho nos Quadros do Azure. Verifique se você está conectado ao projeto que tem esses itens de trabalho e se você tem permissões para ver esses itens de trabalho. Os detalhes do item de trabalho podem também não ser exibidos se a descrição do commit contiver informações incorretas sobre os IDs do item de trabalho no Azure Boards.

P: Como posso alterar a fonte e a cor do CodeLens?

R: Acesse Ferramentas>Opções>Ambiente>Fontes e Cores.

Para usar o teclado:

1. Selecione Alt + T + O para abrir a caixa de diálogo Opções .

2. Selecione a Seta para cima ou Seta para baixo para acessar o nó Ambiente. Em seguida, selecione a Seta para a esquerda para expandir o nó.

3. Selecione a Seta para baixo para acessar Fontes e Cores.

4. Selecione a Guia para acessar a lista Mostrar configurações para e, em seguida, selecione a Seta para baixo para selecionar CodeLens.

P: Posso mover a exibição de cabeçalho do CodeLens?

R: Sim, escolha o ícone Encaixar para encaixar o CodeLens como uma janela.

P: Como atualizar os indicadores?

R: O processo de atualização é diferente dependendo do indicador:

• Referências: este indicador é atualizado automaticamente quando o código é alterado. Se o indicador de Referências estiver encaixado como uma janela separada, atualize o indicador selecionando Atualizar:

  

• Equipe: atualize esses indicadores selecionando Atualizar Indicadores da Equipe CodeLens no menu de clique com o botão direito:

  

• Teste: encontre os testes de unidade do código para atualizar o indicador de Teste.

P: O que é "Versão Local"?

A: A seta de versão local indica o conjunto de alterações mais recente em sua versão local de um arquivo. Quando o servidor tem conjuntos de alterações mais recentes, eles aparecem antes ou depois da seta versão local, dependendo da ordem usada para classificar os conjuntos de alterações.

P: Meus indicadores de teste do CodeLens não aparecem mais no meu arquivo quando abro minha solução pela primeira vez. Como posso carregá-los?

R: Recompile seu projeto para obter os indicadores de teste do CodeLens para carregar no seu arquivo. Para melhorar o desempenho, o Visual Studio não busca mais informações de origem para indicadores de teste quando arquivos de código são carregados. Os indicadores de teste são carregados após um build ou quando você navega até um teste clicando duas vezes nele no Gerenciador de Testes.

Conteúdo relacionado

• Sobre o controle de versão do Git no Visual Studio 2019
• Recursos do editor de código do Visual Studio 2019