Como Alterar a Tecla de Atalho da Sugestão Inline do GitHub Copilot no VS Code

O GitHub Copilot fornece sugestões de código inline enquanto você digita no Visual Studio Code. Por padrão, as teclas de atalho para aceitar ou descartar essas sugestões são definidas pelo VS Code. Muitos usuários acham que as teclas padrão entram em conflito com outras extensões ou preferências pessoais. Este artigo explica como localizar as configurações corretas de atalhos e alterar as teclas para aceitar, descartar e navegar pelas sugestões inline do GitHub Copilot. Você aprenderá os caminhos exatos dos menus e as chaves JSON para modificar.

Entendendo os Atalhos Padrão das Sugestões Inline do GitHub Copilot

As sugestões inline do GitHub Copilot aparecem como texto cinza diretamente no editor. As teclas de atalho padrão são definidas pelo VS Code, não pela extensão do Copilot. As três ações principais são:

• Aceitar uma sugestão: Pressione Tab ou Enter. Tab é o mais comum.
• Descartar uma sugestão: Pressione Escape.
• Navegar pelas sugestões: Use Alt+] (próxima) e Alt+[ (anterior).

Essas teclas não estão armazenadas nas configurações da extensão Copilot. Elas fazem parte do sistema global de atalhos do VS Code. Alterá-las requer editar o arquivo de Atalhos do Teclado. Os comandos que você precisa remapear são editor.action.inlineSuggest.commit para aceitar, editor.action.inlineSuggest.hide para descartar, editor.action.inlineSuggest.showNext para próxima sugestão e editor.action.inlineSuggest.showPrev para sugestão anterior.

Passos para Alterar a Tecla de Atalho da Sugestão Inline

Siga estes passos para atribuir uma nova tecla de atalho a qualquer comando de sugestão inline do GitHub Copilot.

Método 1: Usando o Editor de Atalhos do Teclado

1. Abrir Atalhos do Teclado
   No VS Code, abra a paleta de comandos com Ctrl+K e depois Ctrl+S. Alternativamente, vá em Arquivo > Preferências > Atalhos do Teclado.
2. Pesquisar pelo comando do Copilot
   No campo de pesquisa no topo da visualização de Atalhos do Teclado, digite inlineSuggest. Isso filtra todos os comandos relacionados a sugestões inline. Você verá entradas como “Aceitar Sugestão Inline”, “Ocultar Sugestão Inline”, “Mostrar Próxima Sugestão Inline” e “Mostrar Sugestão Inline Anterior”.
3. Alterar um atalho
   Clique com o botão direito no comando que deseja alterar, por exemplo “Aceitar Sugestão Inline”. Selecione Alterar Atalho. Uma caixa de diálogo aparece. Pressione a nova combinação de teclas e depois pressione Enter para confirmar. Por exemplo, você pode pressionar Ctrl+Espaço para definir uma nova tecla de aceitar.
4. Remover o atalho antigo se necessário
   Se a nova tecla entrar em conflito com outro comando, o VS Code mostra um aviso. Você pode remover o atalho conflitante clicando com o botão direito na entrada duplicada e selecionando Remover Atalho.

Método 2: Editando o keybindings.json Diretamente

1. Abrir keybindings.json
   Na visualização de Atalhos do Teclado, clique no botão Abrir Atalhos do Teclado (JSON) no canto superior direito (um ícone com chaves). Isso abre o arquivo keybindings.json.
2. Adicionar um atalho personalizado
   Insira um novo objeto JSON dentro do array. Use o seguinte modelo para aceitar uma sugestão com Ctrl+Espaço:
   { "key": "ctrl+space", "command": "editor.action.inlineSuggest.commit", "when": "editorTextFocus && inlineSuggestionVisible" }
3. Usar a cláusula when correta
   A cláusula when garante que o atalho funcione apenas quando uma sugestão inline estiver visível. Sem ela, a tecla pode acionar outras ações. Para descartar, use editor.action.inlineSuggest.hide. Para navegar, use editor.action.inlineSuggest.showNext e editor.action.inlineSuggest.showPrev.
4. Salvar o arquivo
   Pressione Ctrl+S para salvar. O novo atalho entra em vigor imediatamente. Teste acionando uma sugestão do Copilot e pressionando sua nova tecla.

Erros Comuns e Limitações

O novo atalho não funciona

Se sua tecla personalizada não fizer nada, verifique a cláusula when. A causa mais comum é a falta da condição inlineSuggestionVisible. Copie a cláusula when exata do atalho padrão. Verifique também se nenhuma outra extensão substitui a mesma tecla. Use a visualização de Atalhos do Teclado para pesquisar conflitos.

A tecla Tab ainda aceita sugestões mesmo após o remapeamento

O VS Code permite múltiplas teclas para o mesmo comando. Se você quiser remover o comportamento padrão da tecla Tab, adicione um novo atalho que o desabilite. Em keybindings.json, adicione: { "key": "tab", "command": "-editor.action.inlineSuggest.commit" }. O sinal de menos antes do nome do comando instrui o VS Code a remover esse atalho. Isso não afeta o Tab para indentação porque a cláusula when só se aplica quando uma sugestão está visível.

O Copilot não mostra sugestões inline

Se o Copilot parar de mostrar sugestões após alterar os atalhos, verifique se a extensão Copilot está habilitada e conectada. A alteração do atalho em si não desabilita as sugestões. Reinicie o VS Code e verifique se a barra de status mostra o ícone do Copilot com uma marca de seleção. Se as sugestões ainda não aparecerem, abra o painel de Saída e selecione “Copilot” no menu suspenso para ver os logs de erro.

Atalhos Padrão vs Atalhos Personalizados para Sugestões Inline

Ação	Atalho Padrão	Exemplo Personalizado
Aceitar sugestão	Tab ou Enter	Ctrl+Espaço
Descartar sugestão	Escape	Ctrl+Shift+Espaço
Mostrar próxima sugestão	Alt+]	Ctrl+Seta para Baixo
Mostrar sugestão anterior	Alt+[	Ctrl+Seta para Cima

Agora você pode atribuir qualquer atalho de teclado para aceitar, descartar ou navegar pelas sugestões inline do GitHub Copilot no VS Code. Use o editor de Atalhos do Teclado para alterações simples ou edite keybindings.json para controle total. Após alterar um atalho, teste-o imediatamente acionando uma sugestão. Para evitar conflitos, inclua sempre a cláusula when editorTextFocus && inlineSuggestionVisible em suas entradas JSON. Para personalização avançada, você também pode remapear a tecla Tab para uma ação diferente, como editor.action.triggerSuggest, para acionar a própria lista de sugestões do VS Code.