TypeScript no VS Code: Setup e Dicas 2026
Configure o VS Code para TypeScript do jeito certo. Extensões, settings.json, IntelliSense e atalhos que triplicam sua produtividade no dia a dia.
Por que isso é importante
TypeScript no VS Code: Setup e Dicas 2026. Configure o VS Code para TypeScript do jeito certo. Extensões, settings.json, IntelliSense e atalhos que triplicam sua produtividade no dia a dia.
Por Que o VS Code É o Melhor Editor Para TypeScript
O VS Code e o TypeScript foram criados pela mesma empresa: Microsoft. Isso não é coincidência. O suporte a TypeScript já vem embutido no editor, sem instalar nada extra. IntelliSense, checagem de tipos em tempo real, refatoração automática — tudo funciona direto da caixa.
Mas o pulo do gato tá nas configurações que vão além do padrão. O VS Code tem um sistema de settings poderoso, extensões que automatizam tarefas repetitivas e integrações com ferramentas de lint e formatação que transformam seu fluxo de trabalho.
O TypeScript Language Service roda dentro do VS Code e entende seu código inteiro. Ele resolve types, infere retornos de função, sugere propriedades de objetos e até detecta variáveis não usadas. Quando você configura tudo certo, o editor praticamente programa junto com você.
Extensões Obrigatórias Para TypeScript no VS Code
Instalar extensões aleatórias mais atrapalha do que ajuda. Aqui vão as que realmente fazem diferença no dia a dia com TypeScript.
Configurando o settings.json Para TypeScript
O arquivo settings.json do VS Code controla tudo. Dá pra ter configurações globais (User Settings) e por projeto (Workspace Settings). Pra TypeScript, vale configurar nos dois níveis.
Settings Globais Recomendados
// .vscode/settings.json
{
// Formatter padrão
"editor.defaultFormatter": "esbenp.prettier-vscode",
"editor.formatOnSave": true,
"editor.formatOnPaste": true,
// TypeScript específico
"typescript.preferences.importModuleSpecifier": "relative",
"typescript.suggest.autoImports": true,
"typescript.updateImportsOnFileMove.enabled": "always",
"typescript.preferences.quoteStyle": "single",
// Organize imports ao salvar
"editor.codeActionsOnSave": {
"source.organizeImports": "explicit",
"source.fixAll.eslint": "explicit"
},
// IntelliSense turbinado
"typescript.suggest.completeFunctionCalls": true,
"typescript.inlayHints.parameterNames.enabled": "all",
"typescript.inlayHints.functionLikeReturnTypes.enabled": true
}
Essas configurações fazem o VS Code formatar e organizar imports automaticamente toda vez que você salva. Acabou a bagunça de imports fora de ordem ou não usados.
Settings de Formatação Prettier + TypeScript
// .prettierrc
{
"semi": true,
"singleQuote": true,
"tabWidth": 2,
"trailingComma": "all",
"printWidth": 80,
"arrowParens": "always",
"endOfLine": "lf"
}
Com Prettier configurado, todo dev do time formata o código igual. Zero discussão sobre estilo. O código fica uniforme em qualquer máquina.
IntelliSense e Auto-Complete Avançado
O IntelliSense do VS Code pra TypeScript é de outro nível. Ele não só sugere nomes de variáveis — ele entende tipos, resolve generics e sugere propriedades com base no contexto. Mas dá pra turbinar ainda mais.
Inlay Hints: Tipos Visíveis no Código
// Com inlay hints ativados, o VS Code mostra:
// Antes (sem hints)
const resultado = calcular(10, 20);
// Depois (com hints visíveis no editor)
const resultado: number = calcular(valor1: 10, valor2: 20);
// Os tipos aparecem em cinza claro, sem poluir o código
// Configuração no settings.json:
{
"typescript.inlayHints.parameterNames.enabled": "all",
"typescript.inlayHints.variableTypes.enabled": true,
"typescript.inlayHints.functionLikeReturnTypes.enabled": true,
"typescript.inlayHints.propertyDeclarationTypes.enabled": true
}
Inlay hints mostram os tipos inferidos diretamente no código sem você precisar passar o mouse. É como ter a documentação de tipos sempre visível.
Code Actions Que Aceleram o Desenvolvimento
// Atalhos de Code Actions no VS Code:
// Ctrl+. (ou Cmd+. no Mac) - Quick Fix
// Exemplos do que aparece:
// - Add missing import
// - Remove unused variable
// - Convert to optional chain
// - Extract to function
// - Generate getter/setter
// Ctrl+Shift+R - Refactor
// Exemplos:
// - Extract variable
// - Extract function
// - Move to new file
// - Rename symbol (F2)
// Shift+Alt+O - Organize Imports
// Remove imports não usados e ordena os restantes
Decore o Ctrl+. (Quick Fix). Ele resolve 80% dos problemas com um clique: imports faltando, variáveis não usadas, conversões de tipo. Use F2 pra renomear variáveis em todos os arquivos de uma vez.
Organize Imports e Formatação Automática
Um dos maiores ganhos de produtividade é nunca mais organizar imports manualmente. O VS Code faz isso sozinho quando você configura certo.
// settings.json - organize imports ao salvar
{
"editor.codeActionsOnSave": {
"source.organizeImports": "explicit",
"source.fixAll.eslint": "explicit",
"source.removeUnusedImports": "explicit"
}
}
// O que isso faz ao salvar:
// 1. Remove imports que você não usa mais
// 2. Ordena imports alfabeticamente
// 3. Agrupa imports por origem (node_modules vs locais)
// 4. Corrige problemas de ESLint automaticamente
// Antes de salvar:
import { useState, useEffect, useCallback } from 'react';
import { z } from 'zod';
import { Button } from '@/components/Button';
import axios from 'axios';
import { Header } from '@/components/Header';
// Depois de salvar (organizado automaticamente):
import { useCallback, useEffect, useState } from 'react';
import axios from 'axios';
import { z } from 'zod';
import { Button } from '@/components/Button';
import { Header } from '@/components/Header';
Com essa configuração, você importa o que precisa de qualquer jeito e o editor cuida da organização. Imports não usados somem sozinhos. O código fica sempre limpo sem esforço.
Atalhos de Teclado Que Todo Dev TypeScript Precisa Saber
Atalhos cortam segundos que se acumulam em horas. Esses são os que mais uso no dia a dia com TypeScript.
// Navegação
Ctrl+Click (Cmd+Click) → Ir pra definição do tipo/função
Alt+← (Ctrl+-) → Voltar pra posição anterior
Ctrl+Shift+F → Buscar em todos os arquivos
Ctrl+P → Abrir arquivo por nome
Ctrl+Shift+O → Ir pra símbolo no arquivo
// Edição
F2 → Renomear símbolo em todo o projeto
Ctrl+. → Quick Fix / Code Actions
Ctrl+D → Selecionar próxima ocorrência
Alt+↑/↓ → Mover linha pra cima/baixo
Ctrl+Shift+K → Deletar linha inteira
// TypeScript específico
Shift+Alt+O → Organize Imports
Ctrl+Shift+M → Abrir painel de Problemas
Ctrl+Space → Forçar IntelliSense
Ctrl+Shift+Space → Ver assinatura da função
// Terminal
Ctrl+` → Abrir/fechar terminal
Ctrl+Shift+` → Novo terminal
Foco nos três mais poderosos: Ctrl+Click pra navegar pelo código, F2 pra renomear com segurança e Ctrl+. pra resolver problemas. Com esses três, você já ganha velocidade absurda.
Configuração de Workspace Específica por Projeto
Projetos diferentes pedem configurações diferentes. Um monorepo React é diferente de um backend Express. O VS Code resolve isso com workspace settings.
// .vscode/settings.json (na raiz do projeto)
{
// TypeScript version do projeto
"typescript.tsdk": "node_modules/typescript/lib",
// Excluir pastas da busca
"search.exclude": {
"**/node_modules": true,
"**/dist": true,
"**/build": true,
"**/.next": true,
"**/coverage": true
},
// Esconder arquivos gerados
"files.exclude": {
"**/*.js.map": true,
"**/dist": true
},
// ESLint pra TypeScript
"eslint.validate": [
"typescript",
"typescriptreact"
],
// Extensões recomendadas pro time
// .vscode/extensions.json
// {
// "recommendations": [
// "dbaeumer.vscode-eslint",
// "esbenp.prettier-vscode",
// "usernamehw.errorlens"
// ]
// }
}
O arquivo .vscode/extensions.json é ouro em times. Quando alguém clona o projeto, o VS Code sugere automaticamente as extensões que o time usa. Todo mundo fica alinhado.
Erros Comuns ao Configurar VS Code com TypeScript
Cuidados na configuração
Usar a versão do TypeScript do VS Code em vez da do projeto: o editor vem com uma versão própria, mas seu projeto pode usar outra. Configure typescript.tsdk pra apontar pra node_modules/typescript/lib e evite incompatibilidades.
ESLint e Prettier em conflito: se os dois tentam formatar, o código fica travando. Use eslint-config-prettier pra desativar as regras de formatação do ESLint e deixe o Prettier cuidar da formatação sozinho.
Instalar extensões demais: cada extensão consome memória e CPU. Mais de 20 extensões ativas já deixa o editor pesado. Instale só o que realmente usa e desative o resto.
Não configurar workspace settings: usar só settings globais significa que todos os seus projetos compartilham a mesma configuração. Projetos diferentes precisam de settings diferentes.
Ignorar o painel de Problemas (Ctrl+Shift+M): esse painel mostra todos os erros TypeScript do projeto inteiro. Dá pra navegar e corrigir sem ficar procurando sublinhados vermelhos arquivo por arquivo.
Checklist de Configuração VS Code + TypeScript
Domine TypeScript com o Editor Certo
Configurar o VS Code é o primeiro passo pra produtividade real com TypeScript. No CrazyStack, você usa essas configurações em projetos de verdade — APIs, frontends React e apps completos. O curso te guia do setup até o deploy com as melhores práticas do mercado.
Se você quer codar TypeScript com velocidade e confiança, comece pelo editor. E quando quiser ir além, o CrazyStack tá esperando.
Continue lendo
Como Configurar Path Aliases no TypeScript
Configure path aliases no tsconfig e nunca mais sofra com importações relativas longas.
Como Configurar ESLint com TypeScript
Setup completo de ESLint para projetos TypeScript com regras que funcionam de verdade.
Como Configurar tsconfig no TypeScript
Domine o tsconfig.json e configure cada opção com segurança.
Interface no TypeScript
Quando usar interface