Como configurar o tamanho da tabulação no Visual Studio Code

Altere Editor: Tab Size nas configurações do VS Code para definir a largura da tabulação. Editor: Insert Spaces define se o editor recua com espaços. Editor: Detect Indentation permite usar o padrão do arquivo aberto. Os caracteres existentes precisam de conversão separada.

Largura da tabulação e caracteres inseridos

editor.tabSize indica a distância entre tabulações em colunas. Por padrão, o tamanho do recuo acompanha esse valor. Um editor.indentSize numérico pode mudar o recuo.

Ative editor.insertSpaces para usar espaços ou desative para usar tabulações. A opção vale para novos recuos e preserva o texto atual.

Configurar os padrões de usuário ou projeto

  1. Na Paleta de Comandos, execute Preferences: Open Settings (UI). Escolha User para os padrões pessoais ou Workspace para o projeto aberto.
  2. Procure editor.tabSize e defina 2. Ative editor.insertSpaces se o projeto usa espaços.
  3. Desative editor.detectIndentation se quiser aplicar esses valores também a arquivos antigos. Reabra um arquivo e procure Spaces: 2 na barra de status.

Em uma área de trabalho de pasta única, combine as entradas abaixo com .vscode/settings.json. Mantenha um só par externo de chaves e atualize as opções existentes.

{
  "editor.tabSize": 2,
  "editor.insertSpaces": true,
  "editor.detectIndentation": false
}

O exemplo usa dois espaços e desativa a detecção no projeto. Anote os valores anteriores e restaure apenas o que mudou ou remova as chaves adicionadas.

Ajustar um arquivo e converter sua indentação

  1. Clique em Spaces ou Tab Size na barra de status. Escolha Indent Using Spaces ou Indent Using Tabs e selecione a largura para novos recuos no arquivo atual.
  2. Para trocar a indentação existente, use Convert Indentation to Spaces ou Convert Indentation to Tabs. Faça o teste em uma cópia e confira o resultado antes de salvar o arquivo desejado.
  3. Altere temporariamente editor.renderWhitespace para all e compare tabulações e espaços. Volte ao valor anterior após a conferência.

Por exemplo, com tamanho 2, ao converter uma linha return 1; que começa com uma tabulação, ela é substituída por dois espaços.

Guia de indentação do VS Code da Microsoft

Conferir valores que não são aplicados

Confira a barra de status. A detecção pode substituir o padrão. Se estiver desligada, examine o Workspace, ajustes por linguagem como [javascript] e um valor separado de editor.indentSize.

Se a indentação só mudar ao salvar, confira a configuração do formatador no projeto. As regras dele podem ser diferentes das do editor.

Prioridade das configurações do VS Code