Instalar .NET no Windows

• Instalar no Windows
• Instalar no macOS
• Instalar no Linux

Este artigo ensina quais versões de .NET têm suporte em Windows, como instalar .NET e qual é a diferença entre o SDK e o runtime.

Ao contrário do .NET Framework, .NET não está vinculado à sua versão do Windows. Você só pode ter uma única versão do .NET Framework instalada no Windows. Mas .NET é autônomo e pode ser instalado em qualquer lugar no computador. Alguns aplicativos podem incluir sua própria cópia de .NET.

Por padrão, .NET é instalado no diretório Program Files\dotnet em seu computador, a menos que o método de instalação escolha um diretório diferente.

Importante

Se você estiver instalando .NET todo o sistema, instale com privilégios administrativos.

.NET é composto pelo runtime e pelo SDK. O runtime executa aplicativos .NET, e o SDK é usado para criar aplicativos.

Escolha o runtime correto

Há três runtimes diferentes para Windows, que permitem a execução de diferentes tipos de aplicativos. O SDK inclui todos os três tempos de execução, e um instalador para um tempo de execução pode incluir um tempo de execução adicional. A tabela a seguir descreve qual runtime está incluído com um instalador de .NET específico:

Instalador	Inclui .NET Runtime	Inclui .NET Desktop Runtime	Inclui ASP.NET Core Runtime
.NET Runtime	Sim	Não	Não
.NET Desktop Runtime	Sim	Sim	Não
ASP.NET Core Runtime	Não	Não	Sim
.NET SDK	Sim	Sim	Sim

Para garantir que você possa executar todos os aplicativos .NET no Windows, instale o ASP.NET Core Runtime e o .NET Desktop Runtime. O ASP.NET Core Runtime executa aplicativos baseados na Web e o .NET Desktop Runtime executa aplicativos da área de trabalho, como um aplicativo Windows Presentation Foundation (WPF) ou Windows Forms.

Escolha como instalar .NET

Há diferentes maneiras de instalar .NET e alguns produtos podem gerenciar sua própria versão do .NET. Se você instalar .NET por meio de software que gerencia sua própria versão do .NET, ele pode não estar habilitado em todo o sistema. Entenda as implicações da instalação de .NET por meio de outros softwares.

Se você não tiver certeza de qual método deve escolher depois de revisar as listas nas seções a seguir, provavelmente deseja usar o .NET Installer.

Desenvolvedores

• Visual Studio

  Use Visual Studio para instalar .NET quando quiser desenvolver aplicativos .NET usando Visual Studio. Visual Studio gerencia sua própria cópia de .NET. Esse método instala os modelos de SDK, Runtime e Visual Studio.

• Visual Studio Code – Kit de Desenvolvimento em C#

  Instale a extensão C# Dev Kit para o Visual Studio Code para desenvolver aplicativos .NET. A extensão pode usar um SDK que já esteja instalado ou instalar um para você.

Usuários e desenvolvedores

• .NET Installer

  Instale .NET com um pacote Windows Installer, que é um executável que você executa. Esse método pode instalar o SDK e o Runtime. As instalações são executadas em todo o sistema.

• Windows Gerenciador de Pacotes (WinGet)

  Use WinGet para instalar .NET quando quiser gerenciar .NET por meio da linha de comando. Esse método pode instalar o SDK e o Runtime. As instalações são executadas em todo o sistema.

• PowerShell

  Um script do PowerShell que pode automatizar a instalação do SDK ou do Runtime. Você pode escolher qual versão do .NET instalar.

Versões suportadas

A tabela a seguir é uma lista de versões de .NET com suporte no momento e as versões de Windows em que há suporte. Essas versões permanecem com suporte até que a versão do .NET atinja o fim do suporte ou a versão do Windows atinja o fim da vida útil.

Dica

Como lembrete, esta tabela se aplica ao .NET moderno, ao invés de .NET Framework. Para instalar o .NET Framework, consulte o guia de instalação do .NET Framework.

As datas de fim de serviço das versões do Windows 10 são organizadas por edição. Somente as edições Home, Pro, Pro Education e Pro for Workstations são consideradas na tabela a seguir. Verifique o documento informativo sobre o ciclo de vida do Windows para obter detalhes específicos.

Sistema operacional	.NET 10 (arquiteturas)	.NET 9 (arquiteturas)	.NET 8 (arquiteturas)
Windows 11 (24H2, 23H2, 22H2 Ent/Edu)	✔️ x64, Arm64	✔️ x64, Arm64	✔️ x64, Arm64
Windows 10 (22H2)	✔️ x64, Arm64	✔️ x64, Arm64	✔️ x64, Arm64
Windows Server 2025 Windows Server 2022 Windows Server 2019 Windows Server, versão 1903 ou posterior Windows Server 2016 Windows Server 2012 R2 Windows Server 2012	✔️ x64, x86	✔️ x64, x86	✔️ x64, x86
Windows Server Core 2012 (e R2)	✔️ x64, x86	✔️ x64, x86	✔️ x64, x86
Nano Server (2025, 2022, 2019)	✔️ x64	✔️ x64	✔️ x64
Windows 8.1	❌	❌	❌
Windows 7 SP1 ESU	❌	❌	❌

Dica

Um símbolo representa a versão mínima.

Windows 7/8.1/Server 2012

Não há mais uma versão de .NET com suporte em Windows 7 e Windows 8.1. As últimas versões com suporte foram .NET 6 e o suporte terminou em 12 de novembro de 2024.

Windows Server 2012 ainda é compatível com qualquer versão de .NET que ainda esteja em suporte.

Todas essas três versões de Windows exigem que outras dependências sejam instaladas:

Sistema operacional	Pré-requisitos
Windows 7 SP1 ESU	- Microsoft Visual C++ 2015-2019 Redistribuível 64-bit/32-bit - KB3063858 64 bits32 bits - Microsoft Root Certificate Authority 2011 (somente instalador offline do .NET Core 2.1)
Windows 8.1	Microsoft Visual C++ 2015-2019 Redistributável 64 bits/32 bits
Windows Server 2012	Microsoft Visual C++ 2015-2019 redistribuível 64-bit32-bit
Windows Server 2012 R2	Microsoft Visual C++ 2015-2019 Redistribuível 64-bit/32-bit

Os requisitos anteriores também serão necessários se você receber um erro relacionado a qualquer uma das seguintes dlls:

• api-ms-win-crt-runtime-l1-1-0.dll
• api-ms-win-cor-timezone-l1-1-0.dll
• hostfxr.dll

PCs Windows baseados em ARM

.NET tem suporte em computadores Windows baseados em Arm. As seções a seguir descrevem as coisas que você deve considerar ao instalar .NET.

Diferenças de caminho

Em um computador Windows baseado em Arm, todas as versões do Arm64 do .NET são instaladas na pasta C:\Program Files\dotnet\. No entanto, a versão x64 do SDK do .NET é instalada na pasta C:\Program Files\dotnet\x64\.

Variáveis de caminho

Variáveis de ambiente que adicionam .NET ao caminho do sistema, como a variável PATH, talvez precisem ser alteradas se você tiver as versões x64 e Arm64 do SDK .NET instaladas. Além disso, algumas ferramentas dependem da variável de ambiente DOTNET_ROOT, que também precisaria ser atualizada para apontar para a pasta de instalação do SDK .NET apropriada.

Instalar com Visual Studio

Visual Studio instala sua própria cópia de .NET separada de outras cópias de .NET. Diferentes versões de Visual Studio dão suporte a diferentes versões de .NET. A versão mais recente do Visual Studio sempre dá suporte à versão mais recente do .NET.

Download Visual Studio Installer

Visual Studio Installer instala e configura Visual Studio. Algumas cargas de trabalho do Visual Studio incluem .NET, como ASP.NET e desenvolvimento web e desenvolvimento de interface do usuário de aplicativos multiplataforma .NET. Versões específicas do .NET podem ser instaladas por meio da guia Individual Components.

A documentação do Visual Studio fornece instruções sobre como:

• Instalar Visual Studio.
• Configurar cargas de trabalho Visual Studio.

captura de tela

.NET versões e Visual Studio

Se você estiver usando Visual Studio para desenvolver aplicativos .NET, a tabela a seguir descreve a versão mínima necessária de Visual Studio com base na versão do SDK de .NET de destino.

versão do SDK do .NET	Visual Studio versão
10	Visual Studio 2026 versão 18.0 ou superior.
9	Visual Studio 2022 versão 17.12 ou superior.
oito	Visual Studio 2022 versão 17.8 ou superior.
7	Visual Studio 2022 versão 17.4 ou superior.
6	Visual Studio 2022 versão 17.0 ou superior.
5	Visual Studio 2019 versão 16.8 ou superior.
3.1	Visual Studio 2019 versão 16.4 ou superior.
3,0	Visual Studio 2019 versão 16.3 ou superior.
2,2	Visual Studio versão 15.9 ou superior de 2017.
2.1	Visual Studio versão 15.7 ou superior de 2017.

Se você já tiver Visual Studio instalado, poderá verificar sua versão com as etapas a seguir.

1. Abra Visual Studio.
2. Selecione Help>About Microsoft Visual Studio.
3. Leia o número da versão na janela "Sobre".

Para obter mais informações sobre, consulte .NET SDK, MSBuild e Visual Studio controle de versão.

Instalar com Visual Studio Code

Visual Studio Code é um editor de código-fonte poderoso e leve que é executado em sua área de trabalho. Visual Studio Code pode usar o SDK já instalado em seu sistema.

Importante

Se você estiver instalando .NET todo o sistema, instale com privilégios administrativos.

Este arquivo de configuração WinGet instala o .NET SDK mais recente, o Visual Studio Code e o DevKit do C#. Se você já tiver qualquer um deles instalado, o WinGet ignorará essa etapa.

1. Baixe o arquivo e clique duas vezes para executá-lo.
2. Leia o contrato de licença, digite ye selecione Enter quando solicitado a aceitar.
3. Se você receber um prompt de UAC (Controle de Conta de Usuário) piscando na barra de tarefas, permita que a instalação continue.

Além disso, a extensão C# Dev Kit instalará .NET se ainda não estiver instalada.

Para obter instruções sobre como instalar .NET por meio de Visual Studio Code, consulte Getting Started with C# in VS Code.

instalador .NET

A página de download do .NET fornece executáveis do Instalador do Windows.

Importante

Se você estiver instalando .NET todo o sistema, instale com privilégios administrativos.

1. Abra um navegador da Web e navegue até https://.

2. Selecione a versão do .NET que você deseja baixar, como 10.0.

3. Localize a caixa SDK ou Runtime que contém os links para baixar .NET.

4. Na coluna Installers, localize a linha Windows e selecione o link para sua arquitetura de CPU. Se você não tiver certeza, selecione x64, pois é o mais comum.

   O navegador deve baixar automaticamente o instalador.

   Dica

   A imagem a seguir mostra o SDK, mas você também pode baixar o Runtime.

   

5. Abra Windows Explorer e navegue até onde o arquivo foi baixado, provavelmente sua pasta Downloads.

6. Clique duas vezes no arquivo para instalar .NET.

   A caixa de diálogo Windows Instalador está aberta.

   

7. Selecione Instalar e siga as instruções para instalar .NET.

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Opções de linha de comando

Use o parâmetro para exibir uma lista de opções.

Se você quiser instalar .NET silenciosamente, como em um ambiente de produção ou para dar suporte à integração contínua, use as seguintes opções:

• /install
  Instala .NET.

• /quiet
  Impede que qualquer interface do usuário e solicitações sejam exibidos.

• /norestart
  Suprime todas as tentativas de reinicialização.

dotnet-sdk-9.0.100-win-x64.exe /install /quiet /norestart

Se você já tiver instalado .NET, use o instalador de .NET para gerenciar a instalação. Em vez de , você pode usar uma das seguintes opções:

• /uninstall
  Remova esta versão do .NET.

• /repair
  Verifique se os principais arquivos ou componentes das instalações estão danificados e restaure-os.

Dica

O instalador retorna um código de saída 0 em caso de sucesso e um código de saída de 3010 para indicar que uma reinicialização é necessária. Qualquer outro valor provavelmente é um código de erro.

Microsoft Update

Os executáveis do instalador .NET são produtos independentes que podem ser atendidos usando o Microsoft Update (MU) no Windows. O MU é diferente do WU (Windows Update), que é usado para atender componentes do sistema operacional, como .NET Framework.

As correções de segurança e não de segurança para versões com suporte de .NET são fornecidas por meio do MU usando vários canais de distribuição. As Atualizações Automáticas (AU) são relevantes para usuários finais e consumidores, enquanto os Serviços de Atualização do Windows Server (WSUS) e Windows Update Catalog são relevantes para os administradores de TI.

Os executáveis do instalador .NET dão suporte a instalações SxS (lado a lado) em versões principais e secundárias para diferentes arquiteturas e componentes, como o runtime e o SDK. Por exemplo, você pode instalar o runtime 6.0.15 (x64) e 6.0.17 (x86). Quando o MU for acionado, ele oferecerá o instalador mais recente para ambas as instalações.

Bloquear atualizações

Embora a maioria dos usuários prefira ser mantida atualizada, é possível bloquear .NET atualizações usando as chaves do Registro na tabela a seguir.

.NET versão	Chave do Registro	Nome	Tipo	Valor
Tudo	HKLM\SOFTWARE\Microsoft\.NET	BlockMU	REG_DWORD	0x00000001
.NET 9	HKLM\SOFTWARE\Microsoft\.NET\9.0	BlockMU	REG_DWORD	0x00000001
.NET 8	HKLM\SOFTWARE\Microsoft\.NET\8.0	BlockMU	REG_DWORD	0x00000001
.NET 7	HKLM\SOFTWARE\Microsoft\.NET\7.0	BlockMU	REG_DWORD	0x00000001
.NET 6	HKLM\SOFTWARE\Microsoft\.NET\6.0	BlockMU	REG_DWORD	0x00000001
.NET 5	HKLM\SOFTWARE\Microsoft\.NET\5.0	BlockMU	REG_DWORD	0x00000001
.NET Core 3.1	HKLM\SOFTWARE\Microsoft\.NET\3.1	BlockMU	REG_DWORD	0x00000001
.NET Core 2.1	HKLM\SOFTWARE\Microsoft\.NET\2.1	BlockMU	REG_DWORD	0x00000001

Atualizações automáticas para o sistema operacional do servidor

As atualizações para sistemas operacionais de servidor são compatíveis com o WSUS e o Catálogo do Microsoft Update, mas não com o AU. Os sistemas operacionais de servidor podem optar por receber atualizações por meio do AU usando as seguintes chaves do Registro.

.NET versão	Chave do Registro	Nome	Tipo	Valor
Tudo	HKLM\SOFTWARE\Microsoft\.NET	AllowAUOnServerOS	REG_DWORD	0x00000001
.NET 9	HKLM\SOFTWARE\Microsoft\.NET\9.0	AllowAUOnServerOS	REG_DWORD	0x00000001
.NET 8	HKLM\SOFTWARE\Microsoft\.NET\8.0	AllowAUOnServerOS	REG_DWORD	0x00000001
.NET 7	HKLM\SOFTWARE\Microsoft\.NET\7.0	AllowAUOnServerOS	REG_DWORD	0x00000001
.NET 6	HKLM\SOFTWARE\Microsoft\.NET\6.0	AllowAUOnServerOS	REG_DWORD	0x00000001
.NET 5	HKLM\SOFTWARE\Microsoft\.NET\5.0	AllowAUOnServerOS	REG_DWORD	0x00000001
.NET Core 3.1	HKLM\SOFTWARE\Microsoft\.NET\3.1	AllowAUOnServerOS	REG_DWORD	0x00000001

WSUS e classificações de atualizações

O WSUS pode ser configurado para fornecer atualizações específicas com base em sua classificação. As atualizações de .NET são classificadas como security ou critical. Se a atualização mais recente for classificada como crítica, uma atualização security mais antiga poderá ser oferecida quando uma versão mais antiga do .NET for instalada substituída pela atualização de segurança mais recente. Isso também se aplica ao uso do CAB offline (Wsusscan2.cab) para verificar um computador.

Observação

Em alguns casos, o WSUS pode relatar uma atualização ausente para uma versão mais antiga do que a versão .NET que você instalou. Por exemplo, imagine que um usuário instale .NET 6.0.36, a versão mais recente do .NET 6. Essa versão é classificada como uma atualização crítica (não de segurança). Em seguida, um aplicativo instala uma versão mais antiga, 6.0.33. (Não é incomum que os aplicativos incluam versões específicas de .NET como um pré-requisito.) Se um administrador configurou o WSUS para fornecer apenas atualizações de segurança, a próxima verificação relatará 6.0.35 como uma atualização ausente. Os computadores configurados para receber atualizações de segurança por meio da AU ou do WSUS serão oferecidos 6.0.35, mesmo quando a 6.0.36 estiver instalada. O motivo disso é que a 6.0.35 substitui a 6.0.33 e é a atualização de segurança mais recente.

Escolha quando as versões anteriores são removidas

Os executáveis do instalador sempre instalam o novo conteúdo antes de remover a instalação anterior. Os aplicativos em execução podem ser interrompidos ou travar quando os tempos de execução mais antigos são removidos. Para minimizar o impacto da atualização .NET, você pode especificar quando uma instalação de .NET anterior deve ser removida usando uma chave do Registro.

.NET versão	Chave do Registro	Nome	Tipo	Valor
Tudo	HKLM\SOFTWARE\Microsoft\.NET	RemoverVersãoAnterior	REG_SZ	, , ou
.NET 10	HKLM\SOFTWARE\Microsoft\.NET\10.0	RemoverVersãoAnterior	REG_SZ	, , ou
.NET 9	HKLM\SOFTWARE\Microsoft\.NET\9.0	RemoverVersãoAnterior	REG_SZ	, , ou
.NET 8	HKLM\SOFTWARE\Microsoft\.NET\8.0	RemoverVersãoAnterior	REG_SZ	, , ou

• never retém instalações anteriores e requer intervenção manual para remover instalações de .NET anteriores.
• remove instalações anteriores após a instalação da nova versão. Esse é o comportamento padrão em .NET.
• adia a remoção até a próxima sessão de login dos membros do grupo de Administradores.
• Os valores não diferenciam maiúsculas de minúsculas e os valores inválidos são padronizados para .

Quando a remoção é adiada, o instalador grava um comando na chave do Registro RunOnce para desinstalar a versão anterior. O comando só será executado se um usuário no grupo Administradores fizer logon na máquina.

Observação

Esse recurso só está disponível a partir do .NET 8 (8.0.11). Ele se aplica apenas aos executáveis do instalador autônomo e afeta distribuições como o WinGet que os usam.

Instalar com Windows Gerenciador de Pacotes (WinGet)

Você pode instalar e gerenciar .NET por meio do serviço Windows Gerenciador de Pacotes, usando a ferramenta winget.exe. Para obter mais informações sobre como instalar e usar o WinGet, consulte Usar a ferramenta winget para instalar e gerenciar aplicativos.

Importante

Se você estiver instalando .NET todo o sistema, instale com privilégios administrativos.

Os pacotes do WinGet .NET são:

• Microsoft.DotNet.Runtime.10 — .NET Runtime 10.0
• Microsoft.DotNet.AspNetCore.10 — ASP.NET Core Runtime 10.0
• Microsoft.DotNet.DesktopRuntime.10 — .NET Desktop Runtime 10.0
• Microsoft.DotNet.SDK.10 — .NET SDK 10.0
• Microsoft.DotNet.Runtime.9 — .NET Runtime 9.0
• Microsoft.DotNet.AspNetCore.9 — ASP.NET Core Runtime 9.0
• Microsoft.DotNet.DesktopRuntime.9 — .NET Desktop Runtime 9.0
• Microsoft.DotNet.SDK.9 — .NET SDK 9.0
• Microsoft.DotNet.Runtime.8 — .NET Runtime 8.0
• Microsoft.DotNet.AspNetCore.8 — ASP.NET Core Runtime 8.0
• Microsoft.DotNet.DesktopRuntime.8 — .NET Desktop Runtime 8.0
• Microsoft.DotNet.SDK.8 — .NET SDK 8.0

Instalar o SDK

Se você instalar o SDK, não será necessário instalar o runtime equivalente.

1. Instale o WinGet.

2. Abra um terminal, como o PowerShell ou o Prompt de Comando.

3. Execute o comando e passe o nome do pacote do SDK:

   winget install Microsoft.DotNet.SDK.10
   

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Instalar o runtime

Há diferentes runtimes que você pode instalar. Consulte a seção Escolher o runtime correto para entender o que está incluído em cada runtime.

1. Instale o WinGet.

2. Abra um terminal, como o PowerShell ou o Prompt de Comando.

3. Execute o comando e passe o nome do pacote do SDK:

   winget install Microsoft.DotNet.DesktopRuntime.10
   winget install Microsoft.DotNet.AspNetCore.10
   

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Pesquisar versões

Use o comando para pesquisar versões diferentes do pacote que você deseja instalar. Por exemplo, o comando a seguir pesquisa todos os SDKs de .NET disponíveis por meio do WinGet:

winget search Microsoft.DotNet.SDK

Os resultados da pesquisa são impressos em uma tabela com cada identificador de pacote.

Name                            Id                           Version                 Source
--------------------------------------------------------------------------------------------
Microsoft .NET SDK 3.1          Microsoft.DotNet.SDK.3_1     3.1.426                 winget
Microsoft .NET SDK 5.0          Microsoft.DotNet.SDK.5       5.0.408                 winget
Microsoft .NET SDK 6.0          Microsoft.DotNet.SDK.6       6.0.428                 winget
Microsoft .NET SDK 7.0          Microsoft.DotNet.SDK.7       7.0.410                 winget
Microsoft .NET SDK 8.0          Microsoft.DotNet.SDK.8       8.0.415                 winget
Microsoft .NET SDK 9.0          Microsoft.DotNet.SDK.9       9.0.306                 winget
Microsoft .NET SDK 10.0         Microsoft.DotNet.SDK.10      10.0.100                winget

Instalar versões prévias

Se uma versão prévia estiver disponível, substitua o número da versão no Id pela palavra . O exemplo a seguir instala a versão prévia do .NET Desktop Runtime:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Instalar com o PowerShell

A instalação de .NET por meio do script dotnet-install do PowerShell é recomendada para instalações de integração contínua e não administrador. Se você estiver instalando .NET para uso normal em seu sistema, use os métodos de instalação .NET Installer ou Windows Gerenciador de Pacotes.

O script usa como padrão a instalação da versão mais recente de Suporte de Longo Prazo (LTS), que é o .NET 10. Você pode escolher uma versão específica definindo a opção . Inclua a opção para instalar um runtime. Caso contrário, o script instala o SDK. O script está disponível em https://dot.net/v1/dotnet-install.ps1 e o código-fonte é hospedado em GitHub.

Baixar o script

Para obter mais informações sobre o script, consulte -referência do script de instalação.

Instalar o ambiente de execução

O .NET Runtime é instalado fornecendo a opção -Runtime.

1. Baixar o script de instalação de

2. Abra o PowerShell e navegue até a pasta que contém o script.

3. Execute os seguintes comandos para instalar o Desktop runtime e o ASP.NET Core runtime para garantir a máxima compatibilidade.

   dotnet-install.ps1 -Runtime windowsdesktop
   dotnet-install.ps1 -Runtime aspnetcore
   

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Instalar o SDK

Se você instalar o SDK, não será necessário instalar os runtimes.

1. Baixar o script de instalação de

2. Abra o PowerShell e navegue até a pasta que contém o script.

3. Execute o comando a seguir para instalar o SDK do .NET.

   dotnet-install.ps1
   

   Observação

   O SDK é instalado omitindo a opção .

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Validação

Depois de fazer o download de um instalador ou de uma versão binária, verifique se o arquivo não foi alterado ou corrompido. Você pode verificar o checksum no seu computador e depois compará-lo com o que foi relatado no site de download.

Quando você baixa o arquivo de uma página oficial de download, a soma de verificação do arquivo é exibida em uma caixa de texto. Selecione o botão Copiar a fim de copiar o valor de soma de verificação para a área de transferência.

Você pode usar o PowerShell ou o prompt de comando para validar a soma de verificação do arquivo baixado. Por exemplo, o comando a seguir informa a soma de verificação do arquivo -sdk-9.0.306-win-x64.exe:

> certutil -hashfile dotnet-sdk-9.0.306-win-x64.exe SHA512
SHA512 hash of dotnet-sdk-9.0.306-win-x64.exe:
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f
CertUtil: -hashfile command completed successfully.

> (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f

Compare a soma de verificação com o valor fornecido pelo site de download.

Usar o PowerShell e um arquivo de soma de verificação para validação

As notas de versão .NET contêm um link para um arquivo de soma de verificação que você pode usar para validar o arquivo baixado. As etapas a seguir descrevem como baixar o arquivo de soma de verificação e validar um binário de instalação .NET:

1. A página de notas de versão do .NET 9 no GitHub em https://github.com/dotnet/core/tree/main/release-notes/9.0 contém uma seção chamada Releases. A tabela nessa seção contém links para os downloads e arquivos de checksum para cada versão do .NET 9. A imagem a seguir mostra a tabela de lançamento do .NET 8 como referência:

   

2. Selecione o link para a versão do .NET que você baixou. A seção anterior usou .NET SDK 9.0.306, que está na versão .NET 9.0.10.

   Dica

   Se você não tiver certeza de qual versão .NET contém o arquivo de soma de verificação, explore os links até encontrá-lo.

3. Na página de versão, você pode ver a versão do .NET Runtime e do .NET SDK, e um link para o arquivo de soma de verificação. A imagem a seguir mostra a tabela de lançamento do .NET 8 como referência:

   

4. Copie o link do arquivo de soma de verificação.

5. Use o script a seguir, mas substitua o link para baixar o arquivo de soma de verificação apropriado:

   Invoke-WebRequest https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt -OutFile 9.0.10-sha.txt
   

6. Com o arquivo de soma de verificação e o arquivo de versão .NET baixado no mesmo diretório, pesquise no arquivo de soma de verificação a soma de verificação do download do .NET:

   Quando a validação for aprovada, você verá True impresso:

   > (Get-Content .\9.0.10-sha.txt | Select-String "dotnet-sdk-9.0.306-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash + "*"
   True
   

   Se "False" for exibido, o arquivo baixado não é válido e não deve ser usado.

Solução de problemas

Depois de instalar o SDK do .NET, você pode encontrar problemas ao tentar executar comandos da CLI .NET. Esta seção coleta esses problemas comuns e fornece soluções.

• No .NET SDK foi encontrado
• A criação de aplicativos está mais lenta do que o esperado
• está ausente

Nenhum SDK .NET foi encontrado

Provavelmente você instalou as versões x86 (32 bits) e x64 (64 bits) do SDK do .NET. Isso está causando um conflito porque, ao executar o comando, ele está sendo resolvido para a versão x86 quando deveria resolver para a versão x64. Esse problema é corrigido ajustando a variável para resolver a versão x64 primeiro.

1. Verifique se você tem as duas versões instaladas executando o comando . Se você fizer isso, deverá encontrar uma entrada para as pastas \ e (x86)\. Se a pasta (x86)\ estiver em primeiro lugar, como mostrado no exemplo a seguir, isso estará incorreto e você deverá prosseguir para a próxima etapa.

   > where.exe dotnet
   C:\Program Files (x86)\dotnet\dotnet.exe
   C:\Program Files\dotnet\dotnet.exe
   

   Dica

   Embora seja usado neste exemplo, você poderá ver outras cópias de .exe listadas. Ajuste-os para que o .exe apropriado seja resolvido primeiro.

   Se estiver correto e Program Files\ for o primeiro, você não terá o problema que esta seção está discutindo e você deve criar um problema de solicitação de ajuda .NET no GitHub.

2. Pressione o botão Windows e digite "Editar as variáveis de ambiente do sistema" na pesquisa. Selecione Editar as variáveis de ambiente do sistema.

   

3. A janela Propriedades do Sistema é aberta para a guia Avançado. Selecione Variáveis de Ambiente.

   

4. Na janela Variáveis de Ambiente, no grupo de variáveis de sistema, selecione a linha "Path*" e, em seguida, o botão Editar.

   A janela de variáveis do ambiente com variáveis de usuário e sistema.

5. Use os botões Mover para Cima e Mover para Baixo para mover a entrada C:\\\ acima de C:\ (x86)\\.

   A lista de variáveis de ambiente do sistema.

A criação de aplicativos está mais lenta do que o esperado

Verifique se o Controle inteligente de aplicativos, um recurso de Windows, está desativado. Não é recomendável habilitar o Controle de Aplicativo Inteligente em computadores usados para desenvolvimento. Qualquer configuração diferente de "off" pode impactar negativamente o desempenho do SDK.

está ausente

Instale o Microsoft Visual C++ 2015-2019 Redistribuível (64 bits ou 32 bits).

Conteúdo relacionado

• .NET visão geral da CLI
• Upgrade para uma nova versão .NET.
• Como verificar se .NET já está instalado.
• Tutorial: Criar um novo aplicativo de console.