Autocompletar¶
Enquanto você digita, um popup oferece complementos para a palavra atual. As sugestões levam em conta o formato do arquivo e vêm de várias fontes, fundidas em uma única lista ordenada e sem duplicatas:
- Palavras-chave da linguagem — as listas de palavras-chave e identificadores
da linguagem detectada do arquivo (palavras-chave de C++ em um
.cpp, funções internas do Python em um.py). - Palavras dos arquivos abertos — todas as palavras já presentes nos seus
buffers abertos, para que seus próprios nomes (
calculateTotal,myVar) sejam completados após o primeiro uso, inclusive entre abas. - Snippets — os prefixos dos snippets aparecem na lista com um glifo marcador; aceitar um deles expande o snippet imediatamente.
- Servidores de linguagem — quando há um servidor LSP em execução para a linguagem do arquivo, os complementos semânticos dele entram na lista.
Usando o popup¶
| Ação | Tecla |
|---|---|
| Acionar manualmente | Ctrl+Space |
| Aceitar a sugestão destacada | Tab ou Enter |
| Descartar | Esc |
O popup também abre sozinho assim que você digita caracteres de palavra suficientes (2 por padrão — configurável). Ele continua filtrando enquanto você digita e se fecha sozinho quando nada corresponde.
Configurações¶
Preferências ▸ Autocompletar:
| Configuração | Padrão | Significado |
|---|---|---|
| Ativar o autocompletar | ligado | Desliga os popups automáticos (o Ctrl+Space manual continua funcionando). |
| Mostrar após digitar N caracteres | 2 | Comprimento mínimo do prefixo antes de o popup abrir automaticamente. |
| Correspondência sem diferenciar maiúsculas | ligado | pri também corresponde a Print. |
| Inserir uma única correspondência sem mostrar a lista | desligado | Quando resta exatamente uma sugestão, inseri-la silenciosamente em vez de mostrar um popup de um item. |
| Linhas visíveis no popup | — | Altura da lista antes de ela rolar. |
| Máximo de sugestões | — | Limite absoluto da lista fundida. |
| Palavras-chave da linguagem | ligado | Liga ou desliga a fonte de palavras-chave. |
| Palavras dos arquivos abertos | ligado | Liga ou desliga a fonte dos buffers abertos. |
Arquivos muito grandes pulam o autocompletar automático (o mesmo limite de tamanho que protege a coloração de sintaxe), então digitar nunca trava.
Relacionado¶
- Snippets — snippets expansíveis com Tab que viajam no mesmo popup.
- LSP (servidor de linguagem) — complementos semânticos, cientes do projeto.
- Pares automáticos e recuo — os demais auxiliares que agem enquanto você digita.