Instalar C#

Coloque o .NET SDK no computador para que o arquivo da introdução realmente rode. Instale o SDK, abra um terminal novo, leia uma linha de versão com dotnet --version, crie uma pasta pequena PineLab, mantenha Console.WriteLine("pine"); no programa e rode dotnet run para a tela mostrar pine. Quando os comandos funcionam, o resultado é o mesmo em Windows, macOS e Linux. Os cliques antes desses comandos mudam conforme o sistema — faça a seção que combina com o computador à sua frente e depois volte à execução compartilhada. Deixe ler cada linha do programa para a página seguinte. Esta lição é a instalação e a primeira execução bem-sucedida, não um site ASP.NET.

O que você está instalando

O download é o .NET SDK. O SDK é o kit que contém o comando dotnet: este curso usa isso para criar um projeto e rodá-lo. Um computador só com o runtime pode rodar alguns apps e ainda falhar nesta página, porque dotnet new e o hábito didático dotnet run precisam do SDK. Você não digita as letras SDK no terminal como palavra mágica. Você instala o kit, e o kit adiciona dotnet.
Pegue o kit na página oficial de download .NET no site da Microsoft (dotnet.microsoft.com). Escolha o SDK, não um pacote só de runtime. Para este curso, pegue a versão 8 ou mais nova. Um lançamento de longo prazo como 8 ou 9 serve. Um número de SDK atual mais alto também serve quando a página oferecer. Não pare num instalador só de runtime quando a página também oferece o SDK. Os números pequenos depois do ponto são o patch. Um computador pode mostrar 8.0.10 e outro 8.0.12. Os dois estão ok quando o número maior é 8 ou acima.

Windows

No Windows, baixe o instalador do SDK para o seu chip (x64 na maioria dos PCs). Abra o instalador e deixe terminar. Deixe ligadas as opções que adicionam dotnet ao PATH quando o instalador as mostrar. PATH é a lista de pastas que o Windows procura quando você digita um comando. Se a pasta do SDK faltar nessa lista, um terminal dirá que não encontra dotnet mesmo com os arquivos no disco.
Um terminal que já estava aberto não vê mudança de PATH. Feche todas as janelas de Command Prompt e PowerShell abertas antes do instalador terminar. Abra uma janela nova. Digite dotnet --version e pressione Enter. A tela escreve uma linha de versão que contém 8 ou um número maior mais alto. Se a janela nova não achar dotnet, abra uma janela ainda mais nova depois de um install SDK concluído com PATH ligado, ou rode o instalador de novo e mantenha o PATH habilitado. Não siga para PineLab enquanto dotnet faltar.

macOS

No macOS, baixe o instalador do SDK que combine com o chip. Macs Apple silicon usam o pacote arm64. Macs Intel antigos usam o pacote x64. Abra o .pkg e termine o Install. Feche o Terminal se já estava aberto e abra o Terminal de novo. Uma janela antiga ainda pode dizer que o comando falta.
No Terminal novo, digite dotnet --version. A tela escreve uma linha de versão com 8 ou um número maior mais alto. Se o comando ainda faltar, termine o .pkg de novo, abra um Terminal novo e digite dotnet --version outra vez. Um diálogo que oferece outro auxiliar estilo Java não é este kit — feche e use o pacote .NET SDK da página oficial de download.

Linux

No Linux, instale o pacote .NET SDK do jeito que sua distribuição instala outros pacotes, com o tipo que a página de download lista para o seu sistema. Quando a instalação do pacote terminar, abra um terminal novo. Digite dotnet --version. A tela escreve uma linha de versão com 8 ou um número maior mais alto. Se o terminal não achar dotnet, termine a instalação do pacote, abra uma janela nova e digite o comando de versão de novo. Os passos compartilhados do projeto abaixo são os mesmos depois que a linha de versão funcionar.

Criar PineLab e rodar pine

A linha de versão não escreve pine. Ela só prova que o SDK está instalado. pine vem do programa. No terminal novo, vá a uma pasta que você controla e então crie um projeto console:
dotnet new console -n PineLab -o PineLab --use-program-main
Entre na pasta:
cd PineLab
Abra Program.cs e mantenha esta forma didática — classe pública Pine, Main e uma linha de escrita:

Salve o arquivo. Na mesma pasta PineLab, digite:
dotnet run
A tela mostra pine. Uma linha. Sem aspas. Sem segunda linha. O nome da classe Pine não é a palavra da tela. A linha de escrita é Console.WriteLine("pine");, a mesma ideia do arquivo de introdução, agora executada depois de um install de verdade.
Se dotnet run não achar um arquivo de projeto, confirme que você está dentro de PineLab onde mora o arquivo .csproj. Se a tela mostrar algo que não seja pine, abra Program.cs e restaure a linha de escrita com "pine" entre as aspas. Reinstalar o SDK não corrige pasta errada.

Hábitos de comando depois do install

Mantenha a prova de versão e a execução pine como duas checagens separadas.

Install ainda não é First Program

A página seguinte abre as linhas do programa uma a uma e ensina qual linha escreve na tela. Esta página só precisa do SDK instalado e de um dotnet run bem-sucedido que mostre pine. Não invente hospedagem ASP.NET aqui. Não pule a regra do terminal novo depois de mudanças de PATH. Não trate um install só de runtime como concluído quando dotnet new falha.
Sem dotnet --version, você não provou o SDK. Sem dotnet run mostrando pine, você não terminou o lab desta página. Mantenha as duas checagens. Afaste hábitos sobrados de Java com javac / java Mint deste install C# — o comando didático aqui é dotnet.

Antes de First Program

Você pode instalar o .NET SDK 8 ou mais novo, abrir um terminal novo, ler dotnet --version, criar PineLab com dotnet new console ... --use-program-main, manter Console.WriteLine("pine"); e rodar dotnet run para a tela mostrar pine. A tabela separa a prova de versão da execução pine. A página seguinte é C# First Program.
Mantenha a pasta PineLab para uma primeira execução clara. Afaste templates ASP.NET desta página ao praticar o install. Afaste rodar da pasta errada. Esses hábitos são o checkpoint antes de First Program. Quando a linha de versão mostrar 8 ou maior e dotnet run mostrar pine, Instalar C# fez o trabalho e você está pronto para First Program se continuar.
Uma última passagem: SDK instalado, terminal novo usado, dotnet --version legível, pasta PineLab presente, linha de escrita ainda "pine", dotnet run imprime pine, nenhum host web exigido. Prefira um caminho de install claro por computador para cada passagem ensinar o mesmo mapa, do download até pine.