Como configurar o VS Code para abrir arquivos Delphi com acentuação correta

Se você costuma editar arquivos Delphi (.pas, .dfm, .dproj) no Visual Studio Code, já deve ter notado um problema comum: acentos e caracteres especiais aparecem incorretos.
Isso acontece porque, por padrão, o VS Code tenta abrir todos os arquivos como UTF-8, enquanto o Delphi usa, na maioria das vezes, ISO-8859-1 (Latin-1).

Neste artigo, você vai aprender como resolver isso de forma definitiva.

⚙️ Por que isso acontece?

O Delphi, especialmente em versões anteriores ao RAD Studio 11, salva seus arquivos-fonte em ISO-8859-1 (Latin-1).
Já o VS Code assume que tudo é UTF-8, e isso causa o problema de caracteres “estranhos” em palavras acentuadas.

Por exemplo:

ação  → a��o
descrição → descri��o

🛠️ Como configurar o VS Code corretamente

A solução é simples: basta criar (ou editar) o arquivo de configurações do usuário do VS Code, chamado settings.json.

O caminho padrão do arquivo é:

C:\Users\Nome-Do-Usuario\AppData\Roaming\Code\User\settings.json<br>

Caso prefira, você não precisa procurar manualmente o arquivo.
Basta abrir o VS Code, pressionar Ctrl + P (ou Ctrl + , para abrir as configurações) e digitar: settings.json

Abra esse arquivo e adicione (ou substitua) o seguinte conteúdo:

"files.associations": {
    "*.pas": "pas",
    "*.dfm": "dfm",
    "*.dproj": "dproj"
},
"[pas]": {
    "files.autoGuessEncoding": false,
    "files.encoding": "iso88591"
},
"[dfm]": {
    "files.autoGuessEncoding": false,
    "files.encoding": "iso88591"
},
"[dproj]": {
    "files.autoGuessEncoding": false,
    "files.encoding": "iso88591"
}

📁 O que essa configuração faz

Vamos entender cada parte:

  • “files.associations”: diz ao VS Code como tratar arquivos com determinadas extensões.
  • “files.autoGuessEncoding”: false: impede o VS Code de tentar “adivinhar” a codificação.
  • “files.encoding”: “iso88591”: define explicitamente a codificação correta usada pelo Delphi.

Assim, ao abrir um .pas ou .dfm, o VS Code já saberá que deve usar ISO-8859-1 e mostrará todos os acentos e caracteres especiais corretamente.


✅ Dica extra

Depois de salvar as configurações, feche e reabra o VS Code.
Em seguida, abra um arquivo .pas ou .dfm e verifique se a acentuação aparece normal.

Se você quiser conferir a codificação usada, olhe no canto inferior direito do VS Code — lá deve aparecer “ISO 8859-1”.


💡 Conclusão

Com essa configuração simples, você pode usar o VS Code para editar arquivos Delphi sem perder a acentuação.
Isso é especialmente útil se você alterna entre o Delphi IDE e o VS Code, aproveitando os recursos de extensão, versionamento e produtividade do editor.