Encontre 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 sem sair do editor de código do IDE (Ambiente de Desenvolvimento Interativo). Você pode encontrar referências a um pedaço de código, alterações em seu código, bugs vinculados, itens de trabalho do Azure DevOps, revisões de código e testes de unidade.

Observação

CodeLens está disponível na edição Community do Visual Studio, mas os indicadores de controlo de código-fonte não estão disponíveis nesta edição.

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

Exiba detalhes sobre as alterações de código do utilizador e clique com o botão direito do rato na opção Enviar e-mail para <utilizador> para entrar em contato com os utilizadores sem sair do editor de código:

Para escolher os indicadores que você deseja ver, ou para desativar e ativar o CodeLens, vá para Ferramentas>Opções>Editor de Texto>Todos os Idiomas>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 mantenha pressionada a tecla Alt para exibir as teclas numéricas relacionadas e, em seguida, selecione o número no teclado que corresponde ao indicador desejado:

Observação

Para selecionar o indicador de avaliações, selecione Alt enquanto usa a tecla de seta para a esquerda e a tecla de seta para a direita para navegar.

Encontrar referências ao seu código

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

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

   

   Observação

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

2. Para visualizar 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 Relacionado e selecione Encontrar Todas as Referências:

Encontrar alterações no seu código

Inspecione o histórico do seu código para descobrir o que aconteceu com ele. Ou revise 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.

Precisas:

• Visual Studio Enterprise ou Visual Studio Professional

• Git ou Azure DevOps Server (anteriormente Team Foundation Server) ou Team Foundation Version Control (TFVC)

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 de nível de elemento de código) dentro do arquivo:

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

Indicadores de nível de elemento de código

Os indicadores de nível de elemento de código permitem que você veja 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 os Serviços de DevOps do Azure:

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 as 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 ao nível do ficheiro

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.

Observação

Os indicadores de nível de arquivo não estão disponíveis para arquivos C# e Visual Basic.

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, visualizar detalhes e acompanhar o conjunto de alterações, obter a versão selecionada do arquivo e enviar um e-mail ao autor dessa alteração. Alguns dos detalhes aparecem em Team Explorer quando ativado; caso contrário, os detalhes aparecerão 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ódigos.

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

A partir do Visual Studio 2022 versão 17.12 Preview 2, pode-se mostrar ou ocultar indicadores de nível de 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 CodeLens de nível de arquivo. Esta opção atualiza a visibilidade para tipos de arquivo que implementam o controle CodeLens no nível de arquivo na barra de rolagem inferior do editor, como XAML, HTML e CSS. A opção não afeta os arquivos que contêm CodeLens embutido (C# e VB).

Encontrar alterações na sua filial atual

Sua equipe pode ter várias ramificações, como uma ramificação principal e uma ramificação de desenvolvimento infantil, para reduzir o risco de quebrar o código estável.

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

Localizar quando o código foi ramificado

Para encontrar quando o seu código foi ramificado, navegue até o código na ramificação secundária. Em seguida, selecione o indicador de alterações (ou selecione Alt+0):

Localizar alterações de entrada de outras filiais

Você pode visualizar as alterações recebidas e não precisa sair da rama atual para revisar uma alteração.

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 em sua ramificação.

Comparar uma alteração recebida com a sua versão local

Para comparar uma alteração recebida 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 Ramo indica como o ramo está relacionado com o ramo em que está a trabalhar.

Ícone	A mudança veio de
	O ramo atual
	A sucursal-mãe
	Ramo secundário
	Uma ramificação de mesmo nível
	Um ramo mais distante do que um pai, filho ou colega
	Mesclagem do ramo principal para um ramo secundário
	Uma mescla de uma ramificação secundária para a ramificação principal
	Uma mesclagem de uma ramificação não relacionada (mesclagem sem base)

Itens de trabalho vinculados

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

Revisões de código vinculado

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

Bugs vinculados

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

Entre em contato com o proprietário de um item

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

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, terá outras opções de comunicação disponíveis.)

Testes unitários associados

Você pode descobrir testes de unidade que existem para seu código C# ou Visual Basic sem abrir Test Explorer.

1. Vá para algum código de aplicação 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. Revise os testes para o código, utilizando o atalho de teclado Alt + 3.

4. Se vir o ícone Aviso , os testes ainda não foram executados, por isso execute-os.

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

6. Para rever os resultados do teste, escolha o estado do teste reprovado ou indicador aprovado ( ou ) ou utilize o atalho de teclado Alt+1.

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

Q & A

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

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

Quando os indicadores estão ativados, você também pode abrir as opções do CodeLens a partir dos indicadores. Além disso, você pode ativar e desativar 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 aparece no código C# e Visual Basic ao nível de métodos, classes, indexadores e propriedades. CodeLens aparece no nível de 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 DevOps do Azure aparecem somente quando os itens de trabalho estão vinculados ao código e quando você tem permissões para abrir itens de trabalho vinculados. Confirme se você tem permissões de membro da equipe.

• Os 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 aparecem automaticamente em projetos de teste. Se você sabe que o código do seu aplicativo tem testes de unidade, mas os indicadores de teste não aparecem, tente criar a solução (Ctrl + Shift + B).

Dica

CodeLens está disponível no Visual Studio edição Community, no entanto, os indicadores de controle de origem não estão disponíveis nesta edição.

P: Porque não vejo os detalhes do item de trabalho de um commit?

R: Esse cenário pode acontecer porque o CodeLens não consegue localizar os itens de trabalho nos Painéis 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 do commit contiver informações incorretas sobre os IDs de item de trabalho nos Quadros do Azure.

P: Como faço para alterar a fonte e a cor do CodeLens?

R: Vá para 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 ir para o nó Ambiente, depois selecione a Seta para a esquerda para expandir o nó.

3. Selecione a seta para baixo para aceder a Fontes e Cores.

4. Selecione Tab para ir para a lista Mostrar definições de e, em seguida, selecione a Seta para baixo para selecionar CodeLens.

P: Posso mover o heads-up display do CodeLens?

R: Sim, escolha o ícone Dock para ancorar o CodeLens como uma janela.

P: Como faço para atualizar os indicadores?

R: O processo de atualização varia de acordo com o indicador:

• Referências: Este indicador atualiza-se automaticamente quando o código é alterado. Se o indicador Referências estiver encaixado como uma janela separada, atualize o indicador selecionando Atualizar.

• Team: Atualize esses indicadores selecionando Atualizar indicadores da equipe do CodeLens no menu do botão direito do mouse.

• pt-PT: Teste: Encontre testes de unidade para o seu código para atualizar o indicador de Teste.

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

A: A seta aponta para o conjunto de alterações mais recente na Versão Local de um ficheiro. 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: Reconstrua o teu projeto para que os indicadores de teste do CodeLens sejam carregados no teu ficheiro. Para melhorar o desempenho, o Visual Studio não busca mais informações de origem para indicadores de teste quando os 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 Teste.

Conteúdo relacionado

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