Antes de rodar a primeira linha de C#, você precisa de duas coisas instaladas: o Visual Studio Community 2022 (a IDE) e o .NET SDK (o compilador e o runtime da linguagem). A boa notícia é que o instalador do Visual Studio já baixa o .NET junto, e você não precisa instalar os dois separadamente se escolher o workload certo.

O que você vai instalar

Dois componentes, papéis bem distintos.

O Visual Studio Community é a versão gratuita da IDE da Microsoft. Ele traz debugger integrado, IntelliSense e gerenciador de projetos. Não confunda com o VS Code: são produtos diferentes da Microsoft (a FAQ no final explica a diferença com detalhes).

O .NET SDK é o coração técnico: ele compila o código C#, roda a aplicação e expõe o comando dotnet no terminal. Com o workload correto no Visual Studio, o SDK é instalado automaticamente junto.

Se você ainda tá se perguntando o que o .NET tem a ver com C#, e qual é a diferença entre .NET e .NET Framework, vale dar uma lida antes de continuar.

Requisitos mínimos para esta instalação:

• Windows 10 versão 1909 (64-bit) ou mais recente
• 4 GB de RAM (8 GB deixa o Visual Studio bem mais rápido)
• 20 GB livres em disco (workload básico ocupa ~6 a 8 GB; com todos os workloads, passa de 40 GB)
• Processador de 1,8 GHz ou mais rápido

Passo 1: Baixar o Visual Studio Community 2022

Acesse visualstudio.microsoft.com/pt-br/downloads e clique em "Download gratuito" abaixo do Community. O que vai baixar é um instalador pequeno (~1,5 MB): ele funciona como um bootstrap que busca os componentes de verdade durante a instalação.

Abra o instalador. Depois de alguns segundos preparando o ambiente, ele vai exibir a tela de seleção de workloads.

Passo 2: Escolher os workloads certos

Essa é a etapa que mais gente passa rápido demais e depois volta com "faltou alguma coisa".

Você não precisa marcar tudo. Pra começar em C# com .NET, selecione pelo menos um desses:

• Desenvolvimento para desktop com .NET: cobre Windows Forms, WPF e aplicações console. Ideal pra quem tá começando do zero com lógica de programação e primeiros projetos.
• Desenvolvimento ASP.NET e Web: se o seu interesse é criar APIs ou sistemas web, marque esse também.

Cada workload inclui o .NET SDK mais recente (hoje o .NET 9). Você não vai precisar instalar o SDK separadamente.

Selecione o(s) workload(s) e clique em "Instalar". O progresso vai aparecer na tela do instalador.

Passo 3: Verificar que o .NET SDK foi instalado

Quando a instalação terminar, abra o Prompt de Comando (Win + R, depois cmd) ou o PowerShell e execute:

dotnet --version

Se aparecer um número de versão, o SDK tá no ar:

9.0.203

Esse número é a versão exata instalada. Máquinas com instalações anteriores podem ter múltiplas versões convivendo. Use dotnet --list-sdks pra listar todas.

Mas se aparecer "comando não reconhecido", o workload provavelmente não foi marcado. Volte ao Visual Studio Installer, clique em "Modificar" e adicione o workload de desenvolvimento .NET.

Passo 4: Criar e rodar seu primeiro projeto C#

Abra o Visual Studio 2022. Na tela inicial, clique em "Criar um novo projeto".

Na busca, escreva Console App. Vai aparecer mais de uma opção: selecione "Console App (.NET)" com o ícone C#. Evite a versão que diz ".NET Framework" no nome, ela é a implementação legada.

Dê um nome ao projeto (algo como MeuPrimeiroProjeto), escolha uma pasta e clique em "Criar".

O Visual Studio vai abrir com um arquivo Program.cs já populado:

Console.WriteLine("Hello, World!");

Pressione F5 ou clique no botão de play verde no topo. Uma janela de console vai abrir com:

Hello, World!

Pronto. Ambiente configurado, primeiro programa rodando.

E se quiser entender onde esse C# se encaixa no mercado e por que ele é usado em fintechs e ERPs grandes no Brasil, tem o artigo O que é C# e por que aprender que cobre exatamente isso.

Problemas comuns (e como resolver)

A instalação trava ou dá erro genérico

Fecha o instalador, reinicia o computador e tenta de novo. O instalador verifica estado de processo e pode conflitar com atualizações do Windows rodando em paralelo. Outra causa comum: antivírus bloqueando arquivos durante a extração. Desative temporariamente durante a instalação e reative quando terminar.

dotnet --version retorna "comando não reconhecido"

Isso acontece quando o .NET foi instalado mas a sessão do terminal não carregou o PATH atualizado. Feche o terminal que estava aberto antes da instalação e abra um novo. O PATH é carregado no início de cada sessão.

Ainda não resolveu? Vai em Configurações do sistema > Variáveis de ambiente e confirme que há uma entrada em PATH com o caminho do dotnet, algo como C:\Program Files\dotnet\.

O Visual Studio abre mas não tem templates C#

Você instalou o Visual Studio sem os workloads de desenvolvimento .NET. Abra o Visual Studio Installer (pesquise no menu Iniciar), clique em "Modificar" na instalação existente e adicione o workload correspondente. Não precisa reinstalar tudo do zero.

Sobre o VS Code como alternativa: se sua máquina for limitada em disco, o VS Code com a extensão C# Dev Kit (da Microsoft) funciona com um setup de ~400 MB no total. Mas o Visual Studio completo tem o debugger e o IntelliSense mais refinados pra .NET. Pra aprendizado de C#, a experiência é melhor, com menos configuração manual no caminho. Quem já usa o VS Code em outras stacks pode preferir ficar nele mesmo.