GitHub Copilot no Depurador do VS Code: Comportamento das Sugestões de Variáveis Inline

Ao depurar código JavaScript, Python ou TypeScript no VS Code, o GitHub Copilot pode exibir sugestões de variáveis inline diretamente no editor. Essas sugestões aparecem como texto cinza ao lado dos nomes das variáveis, mostrando valores previstos ou dicas de tipo. Esse comportamento ocorre porque o Copilot analisa o contexto atual de depuração, incluindo pontos de interrupção, quadros de pilha e estados de variáveis. Este artigo explica por que essas sugestões aparecem, como funcionam e como controlá-las ou desativá-las.

Por que o Copilot Mostra Sugestões de Variáveis Inline Durante a Depuração

O Copilot usa a API de Dicas Inline do VS Code para exibir sugestões de variáveis inline. Quando o depurador está ativo e um ponto de interrupção é atingido, o Copilot lê os valores atuais das variáveis do protocolo do adaptador de depuração. Em seguida, ele prevê o valor ou tipo mais provável para cada variável e o renderiza como uma dica inline diretamente ao lado do nome da variável no editor.

Esse comportamento faz parte do sistema mais amplo de sugestões inline do Copilot, que também inclui conclusões de código e texto fantasma. As sugestões específicas do depurador são projetadas para ajudar você a entender o estado das variáveis sem passar o mouse sobre cada variável ou abrir o painel Variáveis. As sugestões são atualizadas em tempo real conforme você percorre o código.

Como o Copilot Determina os Valores das Variáveis

O Copilot não executa seu código. Em vez disso, ele lê os dados das variáveis fornecidos pela extensão do depurador do VS Code para sua linguagem. Para JavaScript, é o depurador Node.js integrado. Para Python, é a extensão do depurador Python. O depurador envia nomes, tipos e valores atuais das variáveis para o VS Code. O Copilot então formata esses dados em dicas inline.

Quando as Sugestões Inline Aparecem

As sugestões de variáveis inline aparecem apenas quando todas as três condições são verdadeiras:

1. Depurador ativo
   Uma sessão de depuração está em execução e um ponto de interrupção está pausado em uma linha.
2. Variável no escopo
   A variável está definida no quadro de pilha atual e tem um valor conhecido.
3. Dicas inline ativadas
   A configuração do VS Code editor.inlayHints.enabled está definida como "on" ou "onUnlessPressed".

Como Controlar as Sugestões de Variáveis Inline

Você pode ativar, desativar ou personalizar as sugestões de variáveis inline por meio das configurações do VS Code. Existem três métodos: a interface de Configurações, a paleta de comandos e a edição direta do settings.json.

Método 1: Usando a Interface de Configurações

1. Abra as Configurações
   Pressione Ctrl+, no Windows/Linux ou Cmd+, no macOS.
2. Pesquise por dicas inline
   Digite inlay hints na barra de pesquisa no topo.
3. Alterne a configuração
   Em Editor: Dicas Inline > Ativado, escolha uma das três opções:
   – on: Sempre mostrar dicas inline, incluindo sugestões do Copilot
   – onUnlessPressed: Mostrar dicas, a menos que você pressione Ctrl ou Alt (útil para ocultá-las temporariamente)
   – off: Nunca mostrar dicas inline

Método 2: Usando a Paleta de Comandos

1. Abra a Paleta de Comandos
   Pressione Ctrl+Shift+P no Windows/Linux ou Cmd+Shift+P no macOS.
2. Execute o comando
   Digite Developer: Toggle Inlay Hints e pressione Enter. Isso alterna a configuração editor.inlayHints.enabled entre on e off.

Método 3: Editando o settings.json Diretamente

1. Abra o settings.json
   Pressione Ctrl+Shift+P no Windows/Linux ou Cmd+Shift+P no macOS. Digite Preferences: Open Settings (JSON) e pressione Enter.
2. Adicione ou modifique a configuração
   Insira esta linha:
   "editor.inlayHints.enabled": "off"
   Substitua "off" por "on" ou "onUnlessPressed" conforme necessário. Salve o arquivo.

Problemas Comuns com Sugestões de Variáveis Inline

O Copilot Mostra Valores de Variáveis Incorretos ou Desatualizados

O Copilot exibe o valor fornecido pelo depurador. Se o valor parecer errado, verifique se o próprio depurador está mostrando o valor correto no painel Variáveis. Se o depurador mostrar um valor desatualizado, reinicie a sessão de depuração. Isso geralmente acontece quando você edita o código enquanto o depurador está pausado.

Sugestões Inline se Sobrepoõem a Outras Dicas

Se outras extensões também usarem dicas inline, as sugestões podem se sobrepor. Por exemplo, o serviço de linguagem TypeScript mostra dicas de tipo para variáveis. Para reduzir a sobreposição, desative as dicas inline de outras extensões individualmente em suas configurações. Alternativamente, defina editor.inlayHints.enabled como "offUnlessPressed" e mantenha pressionado Ctrl ou Alt para ver as dicas apenas quando necessário.

O Copilot Não Mostra Nenhuma Sugestão Inline

Isso ocorre quando o depurador não está ativo, a variável está fora do escopo ou as dicas inline estão desativadas. Verifique se o depurador está pausado em um ponto de interrupção. Confirme se a variável existe no escopo atual observando o painel Variáveis. Em seguida, confirme se editor.inlayHints.enabled está definido como "on" ou "onUnlessPressed".

Sugestões Inline do Copilot vs Painel de Variáveis do Depurador

Item	Sugestões Inline	Painel Variáveis
Localização	Ao lado do nome da variável no editor	Painel separado na visão Executar e Depurar
Visibilidade	Requer dicas inline ativadas	Sempre visível quando o depurador está ativo
Dados exibidos	Valor ou dica de tipo	Nome, valor, tipo e propriedades aninhadas
Frequência de atualização	A cada etapa do depurador	A cada etapa do depurador
Filtro de escopo	Apenas variáveis no escopo	Variáveis locais, globais e de fechamento
Personalização	Liga/desliga via configuração de dicas inline	Filtrar por escopo, pesquisar e fixar variáveis

As sugestões inline são mais rápidas de ler porque aparecem diretamente no código. O painel Variáveis fornece mais detalhes e é melhor para objetos complexos. Use sugestões inline para verificações rápidas e o painel Variáveis para inspeção aprofundada.

Agora você pode controlar as sugestões de variáveis inline do Copilot durante a depuração no VS Code. Se as sugestões o distraírem, defina editor.inlayHints.enabled como "off" no settings.json. Para um fluxo de depuração mais rápido, mantenha as dicas ativadas, mas use "onUnlessPressed" para ocultá-las temporariamente com Ctrl ou Alt. Combine as dicas inline com o painel Variáveis para a experiência de depuração mais eficiente.