Instalar .NET no Windows

• Instalar no Windows
• Instalar no macOS
• Instalação no Linux

Este artigo ensina-lhe quais as versões do .NET suportadas no Windows, como instalar .NET e qual é a diferença entre o SDK e o runtime.

Ao contrário do .NET Framework, o .NET não está ligado à tua versão do Windows. Só podes ter uma única versão do .NET Framework instalada no Windows. Mas o .NET é autónomo e pode ser instalado em qualquer lugar do teu computador. Algumas aplicações podem incluir a sua própria cópia de .NET.

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

Importante

Se estiver a instalar .NET em todo o sistema, instale com privilégios de administrador.

.NET é composto pelo tempo de execução e pelo SDK. O runtime executa aplicações .NET, e o SDK é usado para criar aplicações.

Escolha o tempo de execução correto

Existem três runtimes diferentes para o Windows, que permitem que diferentes tipos de aplicações corram. O SDK inclui todos os três ambientes de execução, e um instalador para um ambiente de execução pode incluir um ambiente de execução adicional. A tabela seguinte descreve qual o tempo de execução incluído num determinado instalador .NET:

Instalador	Inclui tempo de execução .NET	Inclui .NET Desktop Runtime	Inclui o ASP.NET Core Runtime
.NET Runtime	Sim	Não	Não
.NET Tempo de Execução do Ambiente de Trabalho	Sim	Sim	Não
ASP.NET Core Runtime	Não	Não	Sim
.NET SDK	Sim	Sim	Sim

Para garantir que consegue executar todas as aplicações .NET no Windows, instale tanto o ASP.NET Core Runtime como o .NET Desktop Runtime. O ASP.NET Core Runtime executa aplicações baseadas na web, e o .NET Desktop Runtime executa aplicações de ambiente de trabalho, como uma aplicação Windows Presentation Foundation (WPF) ou Windows Forms.

Escolha como instalar .NET

Existem diferentes formas de instalar o .NET, e alguns produtos podem gerir a sua própria versão do .NET. Se instalar o .NET através de um software que gere a sua própria versão de .NET, pode não estar ativado em todo o sistema. Certifica-te de que compreendes as implicações de instalar .NET através de outro software.

Se não tiver a certeza de qual método deve escolher depois de rever as listas nas secções seguintes, provavelmente vai querer usar o .NET Installer.

Programadores

• Visual Studio

  Use Visual Studio para instalar .NET quando quiser desenvolver .NET aplicações usando Visual Studio. O Visual Studio gere a sua própria cópia do .NET. Este método instala o SDK, o Runtime e os templates do Visual Studio.

• Visual Studio Code - Kit de desenvolvimento em C#

  Instala a extensão C# Dev Kit para o Visual Studio Code para desenvolveres aplicações .NET. A extensão pode usar um SDK que já está instalado ou instalar um para você.

Usuários e desenvolvedores

• .NET Instalador

  Instala o .NET com um pacote Windows Installer, que é um executável que executas. Esse método pode instalar o SDK e o Runtime. As instalações são realizadas em todo o sistema.

• Windows Package Manager (WinGet)

  Usa WinGet para instalar .NET quando quiseres gerir .NET pela linha de comandos. Esse método pode instalar o SDK e o Runtime. As instalações são realizadas em todo o sistema.

• PowerShell

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

Versões suportadas

A tabela seguinte apresenta uma lista das versões .NET atualmente suportadas e das versões do Windows em que são suportadas. Estas versões permanecem suportadas até que a versão do .NET atinja o fim do suporte ou a versão do Windows chegue ao fim da vida útil.

Gorjeta

Como lembrete, esta tabela aplica-se ao .NET moderno (em oposição ao .NET Framework). Para instalar .NET Framework, consulte o guia de instalação .NET Framework.

As datas de fim de serviço das versões do Windows 10 são segmentadas por edição. Apenas as edições Home, Pro, Pro Education e Pro for Workstations são consideradas na tabela a seguir. Consulte a ficha informativa do ciclo de vida Windows para detalhes específicos.

Sistema operativo	.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
Servidor Nano (2025, 2022, 2019)	✔️ x64	✔️ x64	✔️ x64
Windows 8.1	❌	❌	❌
Windows 7 SP1 ESU	❌	❌	❌

Gorjeta

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

Windows 7 / 8.1 / Server 2012

Já não existe uma versão de .NET suportada em Windows 7 e Windows 8.1. A última versão suportada foi a .NET 6 e o suporte terminou a 12 de novembro de 2024.

Windows Server 2012 ainda é suportado por qualquer versão de .NET que ainda esteja em serviço.

Todas estas três versões do Windows requerem dependências adicionais para serem instaladas:

Sistema operativo	Pré-requisitos
Windows 7 SP1 ESU	- Microsoft Visual C++ 2015-2019 Redistribuível 64-bit / 32-bit - KB3063858 64 bits / 32 bits - Microsoft Root Certificate Authority 2011 (apenas para o instalador offline do .NET Core 2.1)
Windows 8.1	Microsoft Visual C++ 2015-2019 Redistribuível de 64 bits / de 32 bits
Windows Server 2012	Microsoft Visual C++ 2015-2019 Redistribuível de 64 bits / de 32 bits
Windows Server 2012 R2	Microsoft Visual C++ 2015-2019 Redistribuível de 64 bits / de 32 bits

Os requisitos anteriores também são necessários se você receber um erro relacionado a 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 é suportado em PCs Windows baseados em Arm. As secções seguintes descrevem aspetos que deve considerar ao instalar .NET.

Diferenças de caminho

Num PC Windows baseado em Arm, todas as versões Arm64 do .NET são instaladas na pasta normal C:\Program Files\dotnet\. No entanto, a versão x64 do SDK .NET está 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, podem precisar de ser alteradas se tiveres 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 teria de ser atualizada para apontar para a pasta de instalação do .NET SDK apropriada.

Instalar com Visual Studio

O Visual Studio instala a sua própria cópia do .NET separada das outras cópias do .NET. Diferentes versões do Visual Studio suportam diferentes versões do .NET. A versão mais recente do Visual Studio suporta sempre a versão mais recente do .NET.

Download Visual Studio Installer

O Visual Studio Installer instala e configura o Visual Studio. Algumas cargas de trabalho Visual Studio incluem .NET, como ASP.NET e desenvolvimento web e .NET desenvolvimento de UI de aplicações multiplataforma. Versões específicas de .NET podem ser instaladas através do separador Componentes Individuais.

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

• Instala Visual Studio.
• Configure cargas de trabalho Visual Studio.

Versões .NET e Visual Studio

Se estiver a usar o Visual Studio para desenvolver aplicações .NET, a tabela seguinte descreve a versão mínima exigida do Visual Studio com base na versão alvo do .NET SDK.

Versão do .NET SDK	Versão Visual Studio
10	Visual Studio 2026 versão 18.0 ou superior.
9	Visual Studio 2022 versão 17.12 ou superior.
8	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 2017 versão 15.9 ou superior.
2.1	Visual Studio 2017 versão 15.7 ou superior.

Se já tiver o Visual Studio instalado, pode verificar a sua versão com os seguintes passos.

1. Abre o Visual Studio.
2. Selecione Ajuda>Sobre a Microsoft Visual Studio.
3. Leia o número da versão na caixa de diálogo Sobre .

Para mais informações, consulte .NET SDK, MSBuild e Visual Studio versionamento.

Instalar com Visual Studio Code

O Visual Studio Code é um editor de código-fonte poderoso e leve que corre no seu ambiente de trabalho. O Visual Studio Code pode usar o SDK já instalado no seu sistema.

Importante

Se estiver a instalar .NET em todo o sistema, instale com privilégios de administrador.

Este ficheiro de configuração WinGet instala o SDK .NET mais recente, Visual Studio Code e o DevKit C#. Se você já tiver algum 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 surgir um aviso de Controle de Conta de Utilizador (UAC) intermitente na barra de tarefas, permita que a instalação prossiga.

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

Para instruções sobre como instalar .NET a Visual Studio Code, veja Começando com C# no VS Code.

Instalador .NET

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

Importante

Se estiver a instalar .NET em todo o sistema, instale com privilégios de administrador.

1. Abra um navegador da Web e navegue até https://dotnethttps://dotnet.microsoft.com/download/dotnet.

2. Selecione a versão do .NET que quer descarregar, como a 10.0.

3. Encontre o SDK ou a caixa de Runtime que contém os links para descarregar .NET.

4. Na coluna Installers, encontre a linha Windows e selecione o link para a arquitetura da sua CPU. Se não tiver certeza, selecione x64 como o mais comum.

   O navegador deve descarregar automaticamente o instalador.

   Gorjeta

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

   

5. Abre Windows Explorador e navega até onde o ficheiro foi descarregado, provavelmente a tua pasta Downloads.

6. Clique duas vezes no ficheiro para instalar o .NET.

   O diálogo do Instalador do Windows é aberto.

   

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

Para aprender a usar a CLI .NET, veja .NET CLI Overview.

Opções da linha de comandos

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

Se quiser instalar o .NET silenciosamente, como num ambiente de produção ou para suportar integração contínua, utilize as seguintes opções:

• /install
  Instala o .NET.

• /quiet
  Impede que qualquer interface e prompts sejam exibidos.

• /norestart
  Suprime quaisquer tentativas de reiniciar.

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

Se já instalou o .NET, use o Instalador .NET para gerir a instalação. Em vez de /install, use uma das seguintes opções:

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

• /repair
  Verifique se os ficheiros ou componentes chave de instalação estão danificados e restaure-os.

Gorjeta

O instalador retorna um código de saída de 0 para 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.

Atualização da Microsoft

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

Tanto as correções de segurança como as não relacionadas com segurança para versões suportadas do .NET são fornecidas através do MU usando múltiplos canais de distribuição. As Atualizações Automáticas (AU) são relevantes para utilizadores finais e consumidores, enquanto os Serviços de Atualização do Windows Server (WSUS) e o Windows Update Catalogue são relevantes para administradores de TI.

Os executáveis do instalador .NET suportam instalações lado a lado (SxS) em versões principais e secundárias para diferentes arquiteturas e componentes, como o runtime e o SDK. Pode-se instalar tanto o runtime 6.0.15 (x64) como o 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 utilizadores prefira manter-se atualizada, é possível bloquear atualizações .NET usando as chaves do registo na tabela seguinte.

Versão .NET	Chave do registo	Nome	Tipo	valor
Todos	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 suportadas pelo WSUS e pelo Catálogo do Microsoft Update, mas não pela AU. Os sistemas operativos de servidor podem optar por receber atualizações através da AU utilizando as seguintes chaves de registo.

Versão .NET	Chave do registo	Nome	Tipo	valor
Todos	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ção

O WSUS pode ser configurado para fornecer atualizações específicas com base na sua classificação. As atualizações para .NET são classificadas como segurança ou críticas. Se a atualização mais recente for classificada como crítica, uma atualização mais antiga security pode ser oferecida quando uma versão mais antiga do .NET é 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 uma máquina.

Nota

Em alguns casos, o WSUS pode reportar uma atualização em falta para uma versão mais antiga do que a versão .NET que instalou. Por exemplo, imagine que um utilizador instala o .NET 6.0.36, a versão mais recente do .NET 6. Esta versão é classificada como uma atualização crítica (não relacionada à segurança). Em seguida, um aplicativo instala uma versão mais antiga, 6.0.33. (Não é incomum que as aplicações incluam versões específicas do .NET como pré-requisito.) Se um administrador configurou o WSUS para fornecer apenas atualizações de segurança, a próxima análise reportará a 6.0.35 como uma atualização em falta. As máquinas configuradas para receber atualizações de segurança através de AU ou WSUS receberão a versão 6.0.35, mesmo quando a versão 6.0.36 estiver instalada. A razão para isso é que 6.0.35 substitui 6.0.33 e é a atualização de segurança mais recente.

Escolher quando as versões anteriores são removidas

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

Versão .NET	Chave do registo	Nome	Tipo	valor
Todos	HKLM\SOFTWARE\Microsoft\.NET	RemoverVersãoAnterior	REG_SZ	always, never ou nextSession
.NET 10	HKLM\SOFTWARE\Microsoft\.NET\10.0	RemoverVersãoAnterior	REG_SZ	always, never ou nextSession
.NET 9	HKLM\SOFTWARE\Microsoft\.NET\9.0	RemoverVersãoAnterior	REG_SZ	always, never ou nextSession
.NET 8	HKLM\SOFTWARE\Microsoft\.NET\8.0	RemoverVersãoAnterior	REG_SZ	always, never ou nextSession

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

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

Nota

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

Instalar com Windows Package Manager (WinGet)

Pode instalar e gerir .NET através do serviço Windows Package Manager, 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 estiver a instalar .NET em todo o sistema, instale com privilégios de administrador.

Os pacotes .NET WinGet 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

Instale o SDK

Se você instalar o SDK, não precisará instalar o tempo de execução correspondente.

1. Instale o WinGet.

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

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

   winget install Microsoft.DotNet.SDK.10
   

Para aprender a usar a CLI .NET, veja .NET CLI Overview.

Instalar o tempo de execução

Há diferentes tempos de execução que você pode instalar. Consulte a seção Escolha o tempo de execução correto para entender o que está incluído em cada tempo de execução.

1. Instale o WinGet.

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

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

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

Para aprender a usar a CLI .NET, veja .NET CLI Overview.

Pesquisar versões

Use o winget search comando para procurar diferentes versões do pacote que você deseja instalar. Por exemplo, o comando seguinte pesquisa todos os SDKs .NET disponíveis via WinGet:

winget search Microsoft.DotNet.SDK

Os resultados da pesquisa são impressos numa 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 de pré-visualização

Se estiver disponível uma versão de pré-visualização, substitua o número da versão no Id pela palavra Preview. O exemplo seguinte instala a versão preliminar do .NET Desktop Runtime:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Instalar com o PowerShell

É recomendado instalar .NET através do script PowerShell dotnet-install para integração contínua e instalações não administrativas. Se estiver a instalar .NET para uso normal no seu sistema, use os métodos de instalação .NET Installer ou Windows Package Manager.

O script instala por defeito a versão de suporte a longo prazo (LTS) mais recente, que é do .NET 10. Você pode escolher uma versão específica especificando o -Channel switch. Inclua o -Runtime switch para instalar um runtime. Caso contrário, o script instalará o SDK. O script está disponível em https://dot.net/v1/dotnet-install.ps1 e o código-fonte está alojado em GitHub.

Faça o download do script

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

Instalar o tempo de execução

O .NET Runtime é instalado fornecendo o switch -Runtime.

1. Baixe o script de instalação de https://dot.net/v1/dotnet-install.ps1

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

3. Execute os seguintes comandos para instalar tanto o tempo de execução do ambiente de trabalho como o do ASP.NET Core para máxima compatibilidade:

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

Para aprender a usar a CLI .NET, veja .NET CLI Overview.

Instale o SDK

Se você instalar o SDK, não precisará instalar os tempos de execução.

1. Baixe o script de instalação de https://dot.net/v1/dotnet-install.ps1

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

3. Execute o seguinte comando para instalar o SDK .NET.

   dotnet-install.ps1
   

   Nota

   O SDK é instalado omitindo o -Runtime switch.

Para aprender a usar a CLI .NET, veja .NET CLI Overview.

Validação

Depois de baixar um instalador ou uma versão binária, verifique-o para certificar-se de que o arquivo não foi alterado ou corrompido. Você pode verificar a soma de verificação no seu computador e, em seguida, compará-la com o que foi relatado no site de download.

Quando você baixa o arquivo de uma página de download oficial, a soma de verificação para o arquivo é exibida em uma caixa de texto. Selecione o botão Copiar para transferir o valor da 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 seguinte comando exibe o checksum do dotnetsdk-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 ficheiro de soma de verificação para validar

As notas de lançamento do .NET contêm um link para um ficheiro de soma de verificação que pode usar para validar o ficheiro descarregado. Os passos seguintes descrevem como descarregar o ficheiro de soma de verificação e validar um binário de instalação .NET:

1. A página de notas de lançamento para .NET 9 em GitHub em https://github.com/dotnet/core/tree/main/release-notes/9.0 contém uma secção chamada Releases. A tabela nessa secção contém ligações para os ficheiros de download e de soma de verificação de cada versão do .NET 9. A imagem seguinte mostra a tabela de lançamentos do .NET 8 como referência:

   

2. Selecione o link da versão do .NET que descarregou. A secção anterior usava o .NET SDK 9.0.306, que está presente na versão .NET 9.0.10.

   Gorjeta

   Se não tiver a certeza de qual versão .NET contém o seu ficheiro de soma de verificação, explore os links até o encontrar.

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

   

4. Copie o link para o 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 tanto o ficheiro de soma de verificação como o ficheiro de release .NET descarregados para o mesmo diretório, procure no ficheiro de soma de verificação o ficheiro de verificação do download .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 vir Falso impresso, o ficheiro que transferiu não é válido e não deve ser utilizado.

Resolução de Problemas

Depois de instalar o SDK .NET, pode ter problemas ao tentar executar comandos de CLI .NET. Esta secção recolhe esses problemas comuns e fornece soluções.

• Não foi encontrado nenhum SDK .NET
• A criação de aplicativos é mais lenta do que o esperado
• hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll está faltando

Não foi encontrado nenhum SDK .NET

Muito provavelmente instalaste tanto as versões x86 (32 bits) como x64 (64 bits) do SDK .NET. Isso está causando um conflito porque quando você executa o dotnet comando, ele está resolvendo para a versão x86 quando deveria resolver para a versão x64. Esse problema é corrigido ajustando a %PATH% variável para resolver a versão x64 primeiro.

1. Verifique se você tem ambas as versões instaladas executando o where.exe dotnet comando. Se o fizer, deverá ver uma entrada para as pastas Program Files\ e Program Files (x86)\. Se a pasta Program Files (x86)\ for a primeira, como demonstrado pelo exemplo a seguir, ela está incorreta e deverá continuar para o próximo passo.

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

   Gorjeta

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

   Se estiver correto e Program Files\ for o primeiro, não tens o problema que esta secção está a discutir e deves criar um pedido de ajuda .NET em GitHub.

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

   

3. A janela Propriedades do sistema é aberta na guia Avançado. Selecione Variáveis de ambiente.

   

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

   

5. Use os botões Mover para cima e Mover para baixo para mover a entrada C:\Program Files\dotnet\ acima C:\Program Files (x86)\dotnet\.

   

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

Certifique-se de que o Smart App Control, uma funcionalidade do Windows, está desligado. O Smart App Control não é recomendado para ser ativado em máquinas usadas para desenvolvimento. Qualquer configuração diferente de "off" pode afetar negativamente o desempenho do SDK.

hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll está faltando

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

Conteúdos relacionados

• .NET Visão geral da Interface de Linha de Comando (CLI)
• Atualizar para uma nova versão .NET.
• Como verificar se .NET já está instalado.
• Tutorial: Cria uma nova aplicação de consola.