1001Ferramentas
⌨️ Dev

Gerador de Keybinding VS Code

Gera entradas para o keybindings.json do VS Code, com tecla, comando e contexto (when). Atalho personalizado em segundos.

Atalho de teclado do VS Code, com a cláusula when certa

O arquivo de atalhos do VS Code é um array de objetos com três campos: a combinação de teclas, o comando e, opcionalmente, a condição em que o atalho vale. Os dois primeiros são óbvios; o terceiro é o que separa uma configuração que funciona de uma que atrapalha, porque sem ele o atalho passa a valer em todo contexto, inclusive dentro do terminal integrado e da caixa de busca.

Preencha os campos e a página monta o JSON pronto para colar. A combinação segue a notação do editor, com as teclas ligadas por sinal de mais e acordes separados por espaço — dois atalhos em sequência, ao estilo do Emacs. O comando é o identificador interno, que se descobre na paleta de comandos ativando a exibição de identificadores.

Sobre a condição, vale conhecer as expressões mais úteis: a que restringe ao editor de texto com foco, a que exige seleção ativa, a que limita a um idioma específico e a que testa se o terminal está em foco. Elas se combinam com os operadores lógicos usuais. Para remover um atalho padrão em vez de sobrescrevê-lo, o caminho é declarar o mesmo comando com um sinal de menos na frente.

Perguntas frequentes

Onde fica o arquivo?
Ele é aberto pela paleta de comandos, na opção de abrir os atalhos em JSON. No disco fica na pasta de configuração do usuário, que varia por sistema. Editar por ali é mais seguro que caçar o caminho, porque o editor valida o JSON enquanto você escreve.
Meu atalho não funciona. Por quê?
As duas causas comuns são conflito e contexto. Conflito se resolve na tela de atalhos, que mostra quando duas entradas disputam a mesma combinação — a última do arquivo vence. Contexto é a cláusula de condição: sem ela o atalho vale em todo lugar, e com ela errada não vale em lugar nenhum.
Como descubro o identificador de um comando?
Na tela de atalhos, o menu de contexto oferece copiar o identificador do comando. Também dá para ativar a exibição de identificadores na paleta de comandos, que passa a mostrar o nome interno ao lado do rótulo — útil quando o comando não tem atalho nenhum ainda.

Ferramentas Relacionadas