Unity com VS Code: Configurar e Fazer o Autocomplete Funcionar

Para usar Unity com VS Code e ter autocomplete de verdade, você precisa de quatro peças ligadas: a extensão Unity da Microsoft no VS Code (que traz o C# Dev Kit junto), o pacote Visual Studio Editor 2.0.20 ou mais novo na Unity, o VS Code escolhido como External Script Editor e os arquivos de projeto gerados pelo botão Regenerate project files. Faltou uma, o VS Code abre o script como texto puro, sem sugestão, sem erro sublinhado e sem saber o que é MonoBehaviour.

Este guia monta a configuração na ordem certa, explica o papel de cada peça e termina com um checklist de unity vscode autocomplete para quando ele some do nada, que é o problema que mais aparece em fórum. Os requisitos foram conferidos na documentação da Unity 6.3 e na página oficial da extensão em outubro de 2026.

Unity com VS Code: o que instalar

A lista completa:

Um ponto que derruba muita gente: existe um pacote antigo chamado Visual Studio Code Editor (com.unity.ide.vscode). A documentação da Unity 6.3 é direta: ele não tem mais suporte e não deve ser usado. Quem cuida do VS Code hoje é o pacote Visual Studio Editor (com.unity.ide.visualstudio), o mesmo que atende o Visual Studio. Se o seu projeto tem o pacote antigo instalado, remova.

Extensões e .NET SDK necessários

1. Instale o .NET

A página da extensão Unity no Marketplace lista como requisito o runtime do .NET 10 ou mais novo. O jeito mais simples de cobrir isso é instalar o .NET SDK atual, que já inclui o runtime:

1. Acesse o site oficial do .NET (dot.net) e baixe o SDK para o seu sistema.
2. Instale e, num terminal novo, rode dotnet --info. Se aparecer a lista de SDKs e runtimes, está certo.

No Mac, o instalador oficial resolve. No Linux, siga o guia da Microsoft para a sua distribuição.

2. Instale a extensão Unity

1. Abra o VS Code e vá em Extensions (Ctrl+Shift+X).
2. Procure por Unity e instale a extensão publicada pela Microsoft (o identificador é visualstudiotoolsforunity.vstuc). Cuidado com extensões de terceiros de nome parecido.
3. Ela instala junto o C# Dev Kit e a extensão C#, que são as dependências dela.
4. O C# Dev Kit pode pedir para você entrar com uma conta Microsoft para ativar. Faça isso, ou parte dos recursos fica desligada.

Sobre licença: o C# Dev Kit segue o modelo de licença do Visual Studio Community, gratuito para uso individual, acadêmico e open source. Empresas acima de certo porte precisam de licença paga do Visual Studio. Para estudante e indie solo, não há custo.

Configurar o External Script Editor

Agora o lado da Unity.

Atualize o pacote Visual Studio Editor

1. Abra o projeto na Unity 6.3.
2. Vá em Window > Package Management > Package Manager.
3. Na lista In Project, ache Visual Studio Editor. Confira se a versão é 2.0.20 ou mais nova. Se houver atualização, clique em Update.
4. Se aparecer Visual Studio Code Editor na mesma lista, selecione e clique em Remove.

Em projetos novos da Unity 6.3, o Visual Studio Editor já vem instalado como parte do conjunto de ferramentas de engenharia, normalmente numa versão bem acima da 2.0.20. O passo serve mais para projetos antigos atualizados.

Escolha o VS Code

1. Vá em Edit > Preferences (no Mac, Unity > Settings).
2. Abra External Tools.
3. Em External Script Editor, escolha Visual Studio Code. Se ele não aparecer na lista, escolha Browse... e aponte para o executável do VS Code.

Logo abaixo aparecem as caixas Generate .csproj files for, com opções como pacotes embutidos, locais, do registro e do Git. Para o dia a dia, deixe o padrão. Marcar tudo deixa o autocomplete mais completo dentro de pacotes, mas aumenta a quantidade de projetos que o VS Code precisa carregar.

Regenerate project files

Ainda em External Tools, clique em Regenerate project files.

O que isso faz: a Unity escreve na raiz do projeto um arquivo .sln e vários .csproj, que dizem ao C# Dev Kit quais scripts existem, quais bibliotecas da Unity referenciar e qual versão do C# usar. É desses arquivos que vem o autocomplete de MonoBehaviour, Transform e todo o resto. Sem eles, o VS Code vê só arquivos .cs soltos.

Agora feche o VS Code, volte para a Unity e clique duas vezes em um script no Project. O VS Code deve abrir a pasta do projeto inteira (não só o arquivo), e na barra inferior aparece o carregamento dos projetos C#. Espere terminar e digite transform. dentro de um método: a lista de sugestões deve aparecer.

Esses arquivos .sln e .csproj são gerados e não precisam ir para o controle de versão. Se você usa Git, eles entram no .gitignore; o post de Git para projeto de jogo mostra a configuração completa.

Configurar o editor de código é o tipo de problema que trava um iniciante por um fim de semana inteiro, e não ensina nada sobre fazer jogo. O tempo que conta é o que vem depois: escrever scripts que se conversam, estruturar o projeto e fechar um jogo. Ter esse caminho guiado poupa justamente as horas que se perdem em configuração e em tutorial desatualizado.

Unity vscode autocomplete não funciona: checklist

Passe na ordem. Cada item resolve uma causa diferente, e a maioria das pessoas para no item 4.

1. O VS Code abriu a pasta do projeto? Se você arrastou um arquivo .cs sozinho, não há projeto carregado. Abra pelo duplo clique na Unity ou use File > Open Folder na raiz do projeto (a pasta que contém Assets).
2. Existe um .sln na raiz do projeto? Se não existe, volte em External Tools e clique em Regenerate project files.
3. O External Script Editor está como Visual Studio Code? Às vezes uma atualização volta para o Visual Studio.
4. O pacote certo está instalado? Visual Studio Editor 2.0.20+ presente, Visual Studio Code Editor removido.
5. A extensão é a da Microsoft? Em Extensions, a extensão Unity precisa estar instalada e habilitada, junto com C# Dev Kit e C#.
6. O C# Dev Kit está ativado? Veja se ele pede login na barra inferior ou nas notificações.
7. O .NET está instalado? Rode dotnet --info num terminal novo. Se o comando não existe, instale o SDK e reinicie o VS Code.
8. O painel Output mostra erro? Em View > Output, escolha C# ou C# Dev Kit no menu do painel. Mensagens sobre SDK não encontrado ou projeto que falhou ao carregar apontam a causa exata.
9. A Unity está com erro de compilação? Se o Console da Unity tem erro vermelho, os arquivos de projeto podem estar desatualizados. Corrija e regenere.
10. Reiniciou? Feche o VS Code, regenere os arquivos na Unity e abra de novo pelo duplo clique. Parece tolo, mas resolve uma parte grande dos casos.
11. Usa Assembly Definitions? Script que referencia código de outro assembly sem a referência declarada no .asmdef mostra erro no VS Code mesmo compilando de outro jeito. Confira as referências do .asmdef.

Se depois de tudo isso só um script específico está sem autocomplete, confira se o nome da classe bate com o nome do arquivo e se ele está dentro de Assets.

Debug com breakpoints no VS Code

Com a extensão Unity, dá para pausar o jogo numa linha e inspecionar variáveis:

1. Com o projeto aberto no VS Code, clique à esquerda do número de uma linha dentro do Update para criar um breakpoint (bolinha vermelha).
2. Aperte F5. A extensão já traz uma configuração para anexar ao editor da Unity aberto. Se ela pedir para escolher, selecione Attach to Unity.
3. A Unity pode perguntar se você quer ativar o modo de depuração de código. Aceite para esta sessão. O ícone de inseto no canto inferior direito da Unity mostra se o modo de debug está ligado.
4. Aperte Play na Unity. Quando a execução chegar na linha, o jogo congela e o VS Code mostra as variáveis do momento.
5. Use F10 para avançar linha por linha e F5 para continuar.

Para depurar um build (o jogo exportado), gere com Development Build e Script Debugging marcados e use o comando Attach Unity Debugger na paleta de comandos (Ctrl+Shift+P), que lista editores e players disponíveis.

Breakpoint resolve em minutos o que Debug.Log resolve em meia hora. Vale aprender cedo. Se ainda está escrevendo os primeiros scripts, o passo a passo de como programar na Unity é um bom lugar para testar.

Visual Studio, VS Code ou Rider: qual escolher

A Unity 6.3 suporta oficialmente os três:

Visual Studio (Windows). É o mais usado no Windows e pode ser instalado junto com a Unity, como módulo, pelo Unity Hub. A integração funciona sem configuração extra. Pesado, mas completo. O Community é gratuito para uso individual.

VS Code (Windows, Mac, Linux). No Mac, com o Visual Studio para Mac descontinuado pela Microsoft, é a opção gratuita mais comum. Leve, rápido para abrir, ótimo se você já usa para outras linguagens. Depende das extensões descritas aqui.

JetBrains Rider (Windows, Mac, Linux). Tem a análise de código mais específica para Unity, com avisos de desempenho e de uso errado da API. Desde outubro de 2024, a JetBrains oferece licença gratuita para uso não comercial (estudo, hobby, open source); uso comercial continua pago.

Minha sugestão prática: no Windows, comece com o Visual Studio que já vem instalado e só troque se ele incomodar. Se você usa Mac, Linux ou já vive no VS Code, siga este guia. Se você estuda a sério e quer o máximo de ajuda do editor, teste o Rider.

Próximo passo

Qualquer que seja a escolha, o editor de código é a ferramenta, não o jogo. Configure uma vez, confirme o autocomplete com transform. e volte para o que interessa. Se a dúvida agora é sobre a linguagem em si, o post sobre qual linguagem a Unity usa explica o C# e o Visual Scripting.