Como Fixar o Estilo de Sugestão do GitHub Copilot nas Configurações do VS Code

Quando você usa o GitHub Copilot no Visual Studio Code, o estilo de sugestão padrão pode não corresponder ao seu fluxo de trabalho preferido. Você pode querer sugestões inline que aparecem como texto fantasma, ou pode preferir um painel separado que lista várias conclusões de uma vez. A configuração que controla esse comportamento é chamada de estilo de sugestão, e é fácil de alterar. Este artigo explica como localizar e fixar a configuração de estilo de sugestão do GitHub Copilot no VS Code para que ele sempre use o formato escolhido.

O que a Configuração de Estilo de Sugestão Controla

O GitHub Copilot no VS Code oferece dois estilos principais de sugestão. O estilo padrão é o texto fantasma inline. Quando você está digitando código, o Copilot mostra uma conclusão esmaecida diretamente no editor na posição do cursor. Você a aceita pressionando Tab. O estilo alternativo mostra as sugestões em uma lista de conclusões separada que aparece abaixo da linha atual. Essa lista se comporta como a lista padrão do IntelliSense no VS Code. Você navega por ela e pressiona Enter ou Tab para inserir a conclusão selecionada.

As principais configurações que controlam esse comportamento estão no arquivo settings.json do VS Code. A configuração github.copilot.editor.enableAutoCompletions ativa ou desativa o texto fantasma inline. Quando é true, o Copilot mostra automaticamente o texto fantasma. Quando é false, o Copilot não mostra sugestões inline, mas você ainda pode acionar sugestões manualmente com Ctrl+Space. A configuração github.copilot.inlineSuggest.enable funciona em conjunto com ela. Quando o texto fantasma inline está desligado, o Copilot usa o estilo de sugestão baseado em lista.

Fixar o estilo de sugestão significa definir esses valores de acordo com sua preferência e travá-los para que não mudem quando você alternar entre espaços de trabalho ou atualizar o VS Code. Você pode fazer isso no arquivo settings.json de nível de usuário ou no de nível de espaço de trabalho. O arquivo de nível de usuário se aplica a todos os projetos. O arquivo de nível de espaço de trabalho se aplica apenas à pasta do projeto atual.

Passos para Fixar o Estilo de Sugestão nas Configurações do VS Code

Siga estes passos para definir o estilo de sugestão do GitHub Copilot e salvá-lo permanentemente.

1. Abra o Editor de Configurações do VS Code
   Pressione Ctrl+, para abrir a aba Configurações. Alternativamente, clique em Arquivo > Preferências > Configurações. O editor de configurações abre com uma barra de pesquisa no topo.
2. Pesquise pela configuração de estilo de sugestão do Copilot
   Na barra de pesquisa, digite github.copilot.editor.enableAutoCompletions. Os resultados mostram um interruptor para esta configuração. Se o interruptor estiver azul, o texto fantasma inline está ativado. Se estiver cinza, o texto fantasma inline está desativado.
3. Defina o interruptor enableAutoCompletions de acordo com sua preferência
   Ligue o interruptor para ativar o texto fantasma inline. Desligue-o para desativar o texto fantasma inline. Quando você o desativa, o Copilot mostrará as sugestões na lista de conclusões.
4. Abra o arquivo settings.json diretamente
   Pressione Ctrl+Shift+P para abrir a Paleta de Comandos. Digite Preferências: Abrir Configurações (JSON) e pressione Enter. O arquivo settings.json abre. Este arquivo contém todas as suas configurações personalizadas em formato JSON.
5. Adicione ou atualize as configurações de estilo de sugestão do Copilot
   Localize a chave github.copilot.editor.enableAutoCompletions. Se ela não existir, adicione-a. Insira o valor como true ou false de acordo com sua preferência. Adicione também a chave github.copilot.inlineSuggest.enable com o valor booleano oposto. Por exemplo, para usar o estilo de lista de conclusões, defina ambas como false. Para usar texto fantasma inline, defina ambas como true. O JSON deve ficar assim:
   "github.copilot.editor.enableAutoCompletions": false,
"github.copilot.inlineSuggest.enable": false
6. Salve o arquivo settings.json
   Pressione Ctrl+S para salvar o arquivo. O VS Code recarrega as configurações imediatamente. Você não precisa reiniciar o editor.
7. Teste o novo estilo de sugestão
   Abra um arquivo de código e comece a digitar. Se você definiu o texto fantasma inline como false, não verá texto fantasma. Pressione Ctrl+Space para acionar manualmente a lista de conclusões. A lista mostra sugestões do Copilot junto com outras conclusões do IntelliSense.

Erros Comuns ao Fixar o Estilo de Sugestão

O Copilot ainda mostra sugestões inline depois que as desativei

Isso acontece quando você tem duas configurações conflitantes. A configuração github.copilot.editor.enableAutoCompletions pode ser false, mas um arquivo settings.json de nível de espaço de trabalho a sobrescreve com true. Verifique tanto o arquivo settings.json de nível de usuário quanto o de nível de espaço de trabalho. O arquivo de espaço de trabalho tem prioridade. Abra o arquivo de nível de espaço de trabalho clicando em Arquivo > Abrir Pasta e depois abrindo a pasta .vscode na raiz do seu projeto. Procure por settings.json dentro dessa pasta.

A lista de sugestões não aparece quando pressiono Ctrl+Space

Isso pode ocorrer se a configuração github.copilot.inlineSuggest.enable estiver definida como true mesmo depois que você desativou as conclusões automáticas. Quando inlineSuggest.enable é true, o Copilot tenta mostrar texto fantasma inline, mas como as conclusões automáticas estão desligadas, nada aparece. Defina github.copilot.inlineSuggest.enable como false para forçar o estilo baseado em lista. Verifique também se o recurso IntelliSense do VS Code não está desativado. Confira a configuração editor.suggest.showMethods e configurações relacionadas de sugestão.

Minhas configurações são redefinidas após uma atualização do VS Code

As atualizações do VS Code não modificam seu arquivo settings.json de usuário. Se as configurações parecerem ser redefinidas, você pode ter um arquivo de configurações corrompido ou uma extensão conflitante. Extensões como Copilot Nightly ou Copilot Chat podem sobrescrever o estilo de sugestão. Desative quaisquer extensões relacionadas ao Copilot, exceto a extensão oficial do GitHub Copilot. Em seguida, reaplique as configurações no settings.json. Verifique também os logs do VS Code em busca de erros. Abra as Ferramentas do Desenvolvedor com Ajuda > Alternar Ferramentas do Desenvolvedor e procure por erros na aba Console.

Texto Fantasma Inline do Copilot vs Estilo de Lista de Conclusões: Principais Diferenças

Item	Texto Fantasma Inline	Lista de Conclusões
Descrição	Sugestões aparecem como texto esmaecido na posição do cursor	Sugestões aparecem em uma lista suspensa abaixo da linha atual
Ativação	Automática, nenhum pressionamento de tecla necessário	Requer acionamento manual com Ctrl+Space
Tecla para aceitar	Tab	Enter ou Tab
Tecla para dispensar	Escape	Escape
Múltiplas sugestões	Navega pelas sugestões com Alt+] e Alt+[	Rola pela lista com as teclas de seta
Sobrescrita de nível de espaço de trabalho	Possível via settings.json do espaço de trabalho	Possível via settings.json do espaço de trabalho

Agora você pode definir o estilo de sugestão do GitHub Copilot como texto fantasma inline ou lista de conclusões usando o arquivo settings.json do VS Code. As principais configurações são github.copilot.editor.enableAutoCompletions e github.copilot.inlineSuggest.enable. Salve o arquivo e teste a alteração digitando em um arquivo de código. Se você trabalha em vários projetos, verifique cada arquivo settings.json de nível de espaço de trabalho em busca de conflitos. Para uma configuração mais avançada, você pode associar um atalho de teclado para alternar entre os dois estilos editando o arquivo keybindings.json com um comando personalizado.