O Quick Pick do GitHub Copilot é um comando do VS Code que permite alternar entre sugestões alternativas de código sem tirar as mãos do teclado. Quando o Copilot oferece uma sugestão inline, você pode querer ver outras opções ou rejeitar a atual. O menu Quick Pick exibe até dez alternativas em uma lista suspensa. Este artigo explica como abrir o menu Quick Pick, interpretar as opções e selecionar a melhor sugestão para seu código.
Principais Pontos: Quick Pick do GitHub Copilot no VS Code
- Ctrl+Enter (Windows/Linux) ou Cmd+Enter (macOS): Abre o menu Quick Pick mostrando sugestões alternativas do Copilot.
- Teclas numéricas 1–9 ou setas + Enter: Seleciona uma sugestão específica da lista Quick Pick.
- Tecla Escape: Fecha o menu Quick Pick sem inserir nenhuma sugestão.
O que o Menu Quick Pick do GitHub Copilot Faz
O menu Quick Pick é um recurso nativo do VS Code que aparece quando você pressiona Ctrl+Enter no Windows/Linux ou Cmd+Enter no macOS enquanto uma sugestão inline do Copilot está ativa. Ele mostra uma lista de alternativas de código que o Copilot gerou para o contexto atual. Cada entrada na lista exibe um trecho do código proposto. Você pode navegar pela lista usando as setas ou pressionando o número correspondente à sugestão. Pressionar Enter insere a sugestão selecionada no seu código. Pressionar Escape fecha o menu sem fazer alterações. O menu também inclui uma opção para abrir o painel completo de conclusões do Copilot, caso precise ver mais de dez alternativas.
O menu Quick Pick é mais útil quando a primeira sugestão inline não é exatamente o que você deseja. Em vez de aceitar ou rejeitar a sugestão inline e digitar manualmente, você pode rapidamente ver outras opções. Isso economiza tempo e ajuda a descobrir abordagens alternativas que o Copilot pode oferecer. O recurso funciona em qualquer linguagem suportada, incluindo Python, JavaScript, TypeScript, C# e Go.
Passos para Abrir e Usar o Menu Quick Pick
Siga estes passos para abrir o menu Quick Pick e selecionar uma sugestão alternativa. Estas instruções pressupõem que você tenha a extensão GitHub Copilot instalada e habilitada no VS Code versão 1.78 ou superior.
- Ative uma sugestão inline do Copilot
Comece a digitar uma linha de código em um arquivo suportado. Após uma breve pausa, o Copilot exibe uma sugestão em texto fantasma (cinza). Não pressione Tab ou Enter ainda. O texto fantasma indica que uma sugestão inline está disponível. - Pressione Ctrl+Enter (Windows/Linux) ou Cmd+Enter (macOS)
Este atalho de teclado abre o menu Quick Pick. Uma lista suspensa aparece perto da posição do cursor. A lista mostra até dez sugestões alternativas. Cada sugestão é numerada de 1 a 10 e inclui uma prévia do código. - Navegue pelas sugestões
Use as setas para cima e para baixo para percorrer a lista. A sugestão selecionada fica destacada. Você também pode pressionar a tecla numérica correspondente à sugestão desejada. Por exemplo, pressione 3 para selecionar a terceira sugestão. A prévia no editor é atualizada conforme você destaca cada opção. - Insira a sugestão selecionada
Pressione Enter para inserir a sugestão destacada no seu código. O texto fantasma inline é substituído pela conclusão escolhida. Se mudar de ideia, pressione Escape para fechar o menu Quick Pick sem inserir nada. A sugestão inline original permanece visível. - Abra o painel completo de conclusões, se necessário
Se o menu Quick Pick mostrar uma mensagem como “Mostrar mais conclusões” ou você quiser ver mais de dez alternativas, role até o final da lista e selecione a opção para abrir o painel de conclusões. Este painel exibe um conjunto maior de sugestões em uma aba separada.
Erros Comuns e Limitações
O menu Quick Pick não aparece
O menu Quick Pick só abre quando uma sugestão inline está ativa. Se você pressionar Ctrl+Enter ou Cmd+Enter e nada acontecer, certifique-se de ter digitado contexto suficiente para o Copilot gerar uma sugestão. Se o texto fantasma não aparecer, tente digitar mais alguns caracteres ou vá para uma nova linha. Verifique também se a extensão GitHub Copilot está habilitada e se você está conectado com uma assinatura ativa.
O Quick Pick mostra apenas uma sugestão
O Copilot gera várias conclusões com base no contexto ao redor. Se o menu Quick Pick mostrar apenas uma ou duas sugestões, o contexto pode ser muito específico ou o arquivo muito curto. Adicione mais linhas de código ou comentários para dar mais informações ao Copilot. Você também pode abrir o painel de conclusões para ver alternativas adicionais.
Inserir acidentalmente a sugestão errada
Se você pressionar Enter enquanto o menu Quick Pick estiver aberto, a sugestão destacada será inserida. Para evitar inserir o código errado, sempre verifique a prévia antes de pressionar Enter. Se inserir uma sugestão incorreta, use Ctrl+Z ou Cmd+Z para desfazer imediatamente.
Menu Quick Pick vs Sugestão Inline: Principais Diferenças
| Item | Menu Quick Pick | Sugestão Inline |
|---|---|---|
| Tecla de ativação | Ctrl+Enter (Windows/Linux) ou Cmd+Enter (macOS) | Automática após breve pausa |
| Número de sugestões exibidas | Até 10 por vez | Uma por vez |
| Método de seleção | Setas, teclas numéricas ou clique do mouse | Tab para aceitar, Escape para descartar |
| Navegação entre alternativas | Lista rolável com prévias | Não disponível; é preciso descartar e reativar |
| Melhor caso de uso | Quando a primeira sugestão não é ideal | Quando a primeira sugestão está correta |
Use o menu Quick Pick quando quiser comparar várias conclusões sem precisar descartar e reativar sugestões manualmente. Use a sugestão inline quando o primeiro texto fantasma for exatamente o que você precisa. Ambos os recursos trabalham juntos para acelerar seu fluxo de codificação.