Dela via


Installera .NET i Windows

Det finns många olika sätt att installera .NET på Windows. Den här artikeln hjälper dig att förstå skillnaden mellan SDK och Runtime, vilken körning du bör installera, och vilken metod du bör använda för att installera .NET.

.NET består av körningen och SDK:et. Körningen kör .NET-appar och SDK används för att skapa appar.

Till skillnad från .NET Framework är .NET inte installerat och kopplat till din version av Windows. Du kan bara ha en enda version av .NET Framework installerad på Windows. .NET kan installeras var som helst på datorn och vissa appar kan innehålla en egen kopia av .NET.

Som standard installeras .NET i katalogen Program Files\dotnet på datorn, såvida inte installationsmetoden väljer en annan katalog.

Välj rätt körning

Det finns tre olika körningar för Windows, som gör att olika typer av appar kan köras. SDK:et innehåller alla tre körningarna. Om du installerar en viss körning kan det omfatta andra körningar. I följande tabell beskrivs vilken körning som ingår i ett visst .NET-installationsprogram:

Innehåller .NET Runtime Innehåller .NET Desktop Runtime Innehåller ASP.NET Core Runtime
.NET Runtime Ja Nej Nej
.NET Desktop Runtime Ja Ja Nej
ASP.NET Core Runtime Nej Nej Ja
.NET SDK Ja Ja Ja

För att säkerställa att du kan köra alla .NET-appar i Windows installerar du både ASP.NET Core Runtime och .NET Desktop Runtime. ASP.NET Core Runtime kör alla webbappar och .NET Desktop Runtime kör alla skrivbordsappar, till exempel en WPF-app (Windows Presentation Foundation) eller En WinForms-app (Windows Forms).

Välj hur du installerar .NET

Det finns olika sätt att installera .NET, och vissa produkter, till exempel Visual Studio, kan hantera sin egen version av .NET. Om du installerar .NET via programvara som hanterar sin egen version av .NET bör du även installera .NET-körningen separat så att du kan köra .NET-appar.

Om du är osäker på vilken metod du ska välja när du har granskat listorna i följande avsnitt vill du förmodligen använda .NET Installer.

Utvecklare

  • Visual Studio

    Använd Visual Studio för att installera .NET när du vill utveckla .NET-appar med Hjälp av Visual Studio. Visual Studio hanterar en egen kopia av .NET. Den här metoden installerar mallarna SDK, Runtime och Visual Studio.

  • Visual Studio Code – C# Dev Kit

    Installera C# Dev Kit-tillägget för Visual Studio Code för att utveckla .NET-appar. Den här metoden använder de SDK:er som du tidigare har installerat.

Användare och utvecklare

  • .NET Installer

    Installera .NET med ett Windows Installer-paket, som är en körbar fil som du kör. Den här metoden kan installera SDK och Runtime. Installationer utförs i hela systemet.

  • Upravljač za pakete za Windows (WinGet)

    Använd WinGet för att installera .NET när du vill hantera .NET via kommandoraden. Den här metoden kan installera SDK och Runtime. Installationer utförs i hela systemet.

  • PowerShell

    Ett PowerShell-skript som kan automatisera installationen av SDK eller Runtime. Du kan välja vilken version av .NET som ska installeras.

Versioner som stöds

Följande tabell är en lista över .NET-versioner som stöds för närvarande och vilka versioner av Windows de stöds på. Dessa versioner stöds fortfarande tills antingen versionen av .NET når supportens slut eller tills versionen av Windows når slutet av livslängden.

Dricks

Som en påminnelse gäller den här tabellen moderna .NET (till skillnad från .NET Framework). Information om hur du installerar .NET Framework finns i installationsguiden för .NET Framework.

Windows 10-versioners slutdatum segmenteras efter utgåva. Endast utgåvorna Home, Pro, Pro Education och Pro for Workstations beaktas i följande tabell. Mer information finns i faktabladet för Windows-livscykeln.

Operativsystem .NET 8 (arkitekturer) .NET 6 (arkitekturer)
Windows 11 ✔️ x64, x86, Arm64 ✔️ x64, Arm64
Windows Server 2022 ✔️ x64, x86 ✔️ x64, x86
Windows 10, version 1607 eller senare ✔️ x64, x86, Arm64 ✔️ x64, x86, Arm64
Windows 8.1 ✔️ x64, x86
Windows 7 SP1 ESU ✔️ x64, x86
Windows Server 2022
Windows Server 2019
Windows Server, version 1903 eller senare
Windows Server 2016
Windows Server 2012 R2
Windows Server 2012
✔️ x64, x86 ✔️ x64, x86
Windows Server Core 2012 (och R2) ✔️ x64, x86 ✔️ x64, x86
Nano Server, version 1809+ ✔️ x64 ✔️ x64
Nano Server, version 1803

Dricks

En + symbol representerar den lägsta versionen.

Windows 7 / 8.1 / Server 2012

Windows 2012 stöds fortfarande med den senaste versionen av .NET, men .NET 6 var den senaste versionen som stödde Windows 7 och Windows 8.1. Alla tre av dessa versioner av Windows kräver att ytterligare beroenden installeras:

Operativsystem Förutsättningar
Windows 7 SP1 ESU – Microsoft Visual C++ 2015-2019 Redistributable 64-bitars / 32-bitars
- KB3063858 64-bitars / 32-bitars
- Microsoft Root Certificate Authority 2011 (endast offlineinstallationsprogrammet för.NET Core 2.1)
Windows 8.1 Microsoft Visual C++ 2015-2019 Redistributable 64-bitars / 32-bitars
Windows Server 2012 Microsoft Visual C++ 2015-2019 Redistributable 64-bitars / 32-bitars
Windows Server 2012 R2 Microsoft Visual C++ 2015-2019 Redistributable 64-bitars / 32-bitars

De tidigare kraven krävs också om du får ett fel som rör någon av följande dll:er:

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

Armbaserade Windows-datorer

I följande avsnitt beskrivs vad du bör tänka på när du installerar .NET på en Arm-baserad Windows-dator.

Vad stöds

I följande tabell beskrivs vilka versioner av .NET som stöds på en Arm-baserad Windows-dator:

.NET-version SDK Körmiljö Sökvägskonflikt Stöds
8 Ja Ja Nej ✔️
8 Ja Ja Nej ✔️
6 Ja Ja Nej ✔️
6 Ja Ja Nej ✔️

X86-, x64- och Arm64-versionerna av .NET SDK finns oberoende av varandra. Om en ny version släpps måste varje arkitekturinstallation uppgraderas.

Sökvägsskillnader

På en Arm-baserad Windows-dator installeras alla Arm64-versioner av .NET i den normala mappen C:\Program Files\dotnet\ . X64-versionen av .NET SDK är dock installerad i mappen C:\Program Files\dotnet\x64\.

Sökvägskonflikter

X64 .NET SDK installeras i en egen katalog enligt beskrivningen i föregående avsnitt. På så sätt kan Arm64- och x64-versionerna av .NET SDK finnas på samma dator. X64 SDK som är äldre än 6.0 stöds dock inte och installeras på samma plats som Arm64-versionen, mappen C:\Program Files\dotnet\. Om du vill installera en x64 SDK som inte stöds måste du först avinstallera Arm64-versionen. Även det motsatta gäller. Du måste avinstallera x64 SDK som inte stöds för att installera Arm64-versionen.

Sökvägsvariabler

Miljövariabler som lägger till .NET i systemsökvägen, till exempel variabeln PATH , kan behöva ändras om du har både x64- och Arm64-versionerna av .NET SDK installerat. Dessutom förlitar sig vissa verktyg på miljövariabeln, som också skulle behöva uppdateras för att peka på DOTNET_ROOT lämplig .NET SDK-installationsmapp.

Installera med Visual Studio

Visual Studio installerar en egen kopia av .NET separat från andra kopior av .NET. Olika versioner av Visual Studio stöder olika versioner av .NET. Den senaste versionen av Visual Studio har alltid stöd för den senaste versionen av .NET.

Visual Studio Installer installerar och konfigurerar Visual Studio. Vissa Visual Studio-arbetsbelastningar omfattar .NET, till exempel ASP.NET och webbutveckling och .NET Multi-platform App UI-utveckling. Specifika versioner av .NET kan installeras via fliken Enskilda komponenter .

Visual Studio-dokumentationen innehåller instruktioner om hur du:

En skärmbild som visar Visual Studio Installer med .NET Desktop-arbetsbelastningen markerad med en röd ruta.

.NET-versioner och Visual Studio

Om du använder Visual Studio för att utveckla .NET-appar beskriver följande tabell den lägsta nödvändiga versionen av Visual Studio baserat på målversionen av .NET SDK.

.NET SDK-version Visual Studio-version
8 Visual Studio 2022 version 17.8 eller senare.
7 Visual Studio 2022 version 17.4 eller senare.
6 Visual Studio 2022 version 17.0 eller senare.
5 Visual Studio 2019 version 16.8 eller senare.
3.1 Visual Studio 2019 version 16.4 eller senare.
3,0 Visual Studio 2019 version 16.3 eller senare.
2,2 Visual Studio 2017 version 15.9 eller senare.
2.1 Visual Studio 2017 version 15.7 eller senare.

Om du redan har Visual Studio installerat kan du kontrollera din version med följande steg.

  1. Öppna Visual Studio.
  2. Välj Hjälp>om Microsoft Visual Studio.
  3. Läs versionsnumret från dialogrutan Om .

Mer information om finns i versionshantering för .NET SDK, MSBuild och Visual Studio.

Installera med Visual Studio Code

Visual Studio Code använder de versioner av .NET som redan är installerade på systemet. Installera .NET med hjälp av antingen .NET Installer eller Upravljač za pakete za Windows. Visual Studio installerar en egen kopia av .NET som inte kan användas av Visual Studio Code.

.NET-appar skapas i Visual Studio Code med C# Dev Kit-tillägget.

  1. Installera först .NET SDK genom att följa stegen i något av de andra avsnitten, förutom avsnittet i Visual Studio.

  2. Installera sedan Visual Studio Code, om du inte redan har gjort det. Mer information finns i Visual Studio Code i Windows.

  3. Slutligen installerar du C# Dev Kit-tillägget. Mer information finns i Komma igång med C# i VS Code.

.NET Installer

Nedladdningssidan för .NET innehåller körbara Windows Installer-filer.

  1. Öppna en webbläsare och gå till https://dotnet.microsoft.com/download/dotnet.

  2. Välj den version av .NET som du vill ladda ned, till exempel 8.0.

  3. Leta upp rutan SDK eller Runtime som innehåller länkarna för att ladda ned .NET.

  4. Under kolumnen Installationsprogram letar du upp raden Windows och väljer länken för cpu-arkitekturen. Om du är osäker väljer du x64 eftersom det är det vanligaste.

    Webbläsaren laddar automatiskt ned MSI-paketet.

    Dricks

    Följande bild visar SDK, men du kan också ladda ned Runtime.

    En bild av nedladdningssidan för .NET med nedladdningslänken för SDK markerad.

  5. Öppna Utforskaren och navigera till platsen där filen laddades ned, troligtvis mappen Nedladdningar .

  6. Dubbelklicka på filen för att installera .NET.

    Dialogrutan Windows Installer öppnas.

    En skärmbild av installationsappfönstret för .NET MSI.

  7. Välj Installera och följ anvisningarna för att installera .NET.

Information om hur du använder .NET CLI finns i .NET CLI-översikt.

Alternativ för kommandoraden

Om du vill installera .NET tyst, till exempel i en produktionsmiljö eller för att stödja kontinuerlig integrering, använder du följande Windows Installer-alternativ:

  • /install
    Installerar .NET.

  • /quiet
    Förhindrar att användargränssnitt och uppmaningar visas.

  • /norestart
    Suppresses any attempts to restart.

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

Mer information finns i Kommandoradsalternativ för standardinstallationsprogrammet.

Dricks

Installationsprogrammet returnerar en slutkod på 0 för att lyckas och en slutkod på 3010 för att indikera att en omstart krävs. Alla andra värden är troligen en felkod.

Installera med Upravljač za pakete za Windows (WinGet)

Du kan installera och hantera .NET via Upravljač za pakete za Windows-tjänsten med hjälp av winget.exe verktyget. Mer information om hur du installerar och använder WinGet finns i Använda winget-verktyget för att installera och hantera program.

Om du installerar .NET systemomfattande installerar du med administratörsbehörighet.

.NET WinGet-paketen är:

  • 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

Installera SDK:n

Om du installerar SDK:t behöver du inte installera motsvarande körning.

  1. Installera WinGet.

  2. Öppna en terminal, till exempel PowerShell eller cmd.exe.

  3. winget install Kör kommandot och skicka namnet på SDK-paketet:

    winget install Microsoft.DotNet.SDK.8
    

Information om hur du använder .NET CLI finns i .NET CLI-översikt.

Installera körningen

Det finns olika körningar som du kan installera. Se avsnittet Välj rätt körning för att förstå vad som ingår i varje körning.

  1. Installera WinGet.

  2. Öppna en terminal, till exempel PowerShell eller Kommandotolken.

  3. winget install Kör kommandot och skicka namnet på SDK-paketet:

    winget install Microsoft.DotNet.DesktopRuntime.8
    winget install Microsoft.DotNet.AspNetCore.8
    

Information om hur du använder .NET CLI finns i .NET CLI-översikt.

Sök efter versioner

winget search Använd kommandot för att söka efter olika versioner av paketet som du vill installera. Följande kommando söker till exempel efter alla .NET SDK:er som är tillgängliga via WinGet:

winget search Microsoft.DotNet.SDK

Sökresultaten skrivs ut i en tabell med varje paketidentifierare.

Name                           Id                           Version                    Source
----------------------------------------------------------------------------------------------
Microsoft .NET SDK 9.0 Preview Microsoft.DotNet.SDK.Preview 9.0.100-preview.3.24204.13 winget
Microsoft .NET SDK 8.0         Microsoft.DotNet.SDK.8       8.0.300                    winget
Microsoft .NET SDK 7.0         Microsoft.DotNet.SDK.7       7.0.409                    winget
Microsoft .NET SDK 6.0         Microsoft.DotNet.SDK.6       6.0.422                    winget
Microsoft .NET SDK 5.0         Microsoft.DotNet.SDK.5       5.0.408                    winget
Microsoft .NET SDK 3.1         Microsoft.DotNet.SDK.3_1     3.1.426                    winget

Installera förhandsversioner

Du kan installera förhandsversioner genom att ersätta versionsnumret, till exempel 8, med ordet Preview. I följande exempel installeras förhandsversionen av .NET Desktop Runtime:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Installera med PowerShell

Installation av .NET via dotnet-install PowerShell-skriptet rekommenderas för kontinuerlig integrering och icke-standardinstallationer. Om du installerar .NET för normal användning i systemet använder du antingen installationsmetoderna .NET Installer eller Upravljač za pakete za Windows.

Skriptet installerar som standard den senaste lts-versionen (long term support), som är .NET 8. Du kan välja en specifik version genom att ange växeln -Channel . Inkludera växeln -Runtime för att installera en körning. Annars installerar skriptet SDK: et. Skriptet är tillgängligt på https://dot.net/v1/dotnet-install.ps1 och källkoden finns på GitHub.

Mer information om skriptet finns i skriptreferensen dotnet-install.

Installera körningen

.NET Runtime installeras genom att ange växeln -Runtime .

  1. Ladda ned installationsskriptet från https://dot.net/v1/dotnet-install.ps1

  2. Öppna PowerShell och navigera till mappen som innehåller skriptet.

  3. Kör följande kommandon för att installera både Desktop-körningen och ASP.NET Core-körningen för maximal kompatibilitet:

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

Information om hur du använder .NET CLI finns i .NET CLI-översikt.

Installera SDK:n

Om du installerar SDK:t behöver du inte installera körningen.

  1. Ladda ned installationsskriptet från https://dot.net/v1/dotnet-install.ps1

  2. Öppna PowerShell och navigera till mappen som innehåller skriptet.

  3. Kör följande kommando för att installera .NET SDK.

    dotnet-install.ps1
    

    Kommentar

    SDK:et installeras genom att växeln utelämnas -Runtime .

Information om hur du använder .NET CLI finns i .NET CLI-översikt.

Validering

När du har laddat ned ett installationsprogram kontrollerar du att filen inte har ändrats eller skadats. Du kan kontrollera kontrollsumman på datorn och sedan jämföra den med vad som rapporterades på nedladdningswebbplatsen.

När du laddar ned ett installationsprogram eller en binär fil från en officiell nedladdningssida visas kontrollsumman för filen. Välj knappen Kopiera för att kopiera kontrollsummavärdet till Urklipp.

Nedladdningssidan för .NET med kontrollsumma

Du kan använda PowerShell eller kommandotolken för att verifiera kontrollsumman för filen som du har laddat ned. Följande kommando rapporterar till exempel kontrollsumman för filen dotnet-sdk-8.0.100-win-x64.exe :

> certutil -hashfile dotnet-sdk-8.0.100-win-x64.exe SHA512
SHA512 hash of dotnet-sdk-8.0.100-win-x64.exe:
248acec95b381e5302255310fb9396267fd74a4a2dc2c3a5989031969cb31f8270cbd14bda1bc0352ac90f8138bddad1a58e4af1e56cc4a1613b1cf2854b518e
CertUtil: -hashfile command completed successfully.
> (Get-FileHash .\dotnet-sdk-8.0.100-win-x64.exe -Algorithm SHA512).Hash
248acec95b381e5302255310fb9396267fd74a4a2dc2c3a5989031969cb31f8270cbd14bda1bc0352ac90f8138bddad1a58e4af1e56cc4a1613b1cf2854b518e

Jämför kontrollsumman med värdet som tillhandahålls av nedladdningswebbplatsen.

Använd PowerShell och en kontrollsummafil för att verifiera

Viktig information om .NET innehåller en länk till en checksumfil som du kan använda för att verifiera den nedladdade filen. Följande steg beskriver hur du laddar ned checksum-filen och validerar en .NET-installationsbinär fil:

  1. Sidan viktig information för .NET 8 på GitHub på https://github.com/dotnet/core/tree/main/release-notes/8.0 innehåller ett avsnitt med namnet Versioner. Tabellen i det avsnittet länkar till nedladdningar och kontrollsummor för varje .NET 8-version:

    Versionstabellen för github-versionsanteckningar för .NET

  2. Välj länken för den version av .NET som du laddade ned. I föregående avsnitt användes .NET SDK 8.0.100, som finns i .NET 8.0.0-versionen.

    Dricks

    Om du inte är säker på vilken .NET-version som innehåller din checksumfil kan du utforska länkarna tills du hittar den.

  3. På versionssidan kan du se .NET Runtime- och .NET SDK-versionen och en länk till kontrollsummafilen:

    Nedladdningstabellen med kontrollsummor för .NET

  4. Kopiera länken till checksum-filen.

  5. Använd följande skript, men ersätt länken för att ladda ned lämplig kontrollsummafil:

    Invoke-WebRequest https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt -OutFile 8.0.0-sha.txt
    
  6. Med både checksum-filen och .NET-versionsfilen nedladdad till samma katalog söker du i checksum-filen efter kontrollsumman för .NET-nedladdningen:

    När valideringen godkänns ser du Sant utskrivet:

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

    Om du ser falskt utskrivet är filen du laddade ned inte giltig och bör inte användas.

Felsökning

När du har installerat .NET SDK kan det uppstå problem med att köra .NET CLI-kommandon. Det här avsnittet samlar in dessa vanliga problem och tillhandahåller lösningar.

Ingen .NET SDK hittades

Troligtvis har du installerat både x86- (32-bitars) och x64-versioner (64-bitars) av .NET SDK. Detta orsakar en konflikt eftersom när du kör dotnet kommandot matchas det till x86-versionen när det ska matcha till x64-versionen. Det här problemet åtgärdas genom att justera variabeln %PATH% för att lösa x64-versionen först.

  1. Kontrollera att båda versionerna är installerade genom att where.exe dotnet köra kommandot . Om du gör det bör du se en post för mapparna Program Files\ och Program Files (x86)\ . Om mappen Program Files (x86)\ är först, vilket visas i följande exempel, är den felaktig och du bör fortsätta till nästa steg.

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

    Om det är korrekt och Program Files\ är först har du inte det problem som det här avsnittet diskuterar och du bör skapa ett problem med .NET-hjälpbegäran på GitHub

  2. Tryck på Windows-knappen och skriv "Redigera systemmiljövariablerna" i sökningen. Välj Redigera systemmiljövariablerna.

    Startmenyn i Windows med variabeln Redigera miljö

  3. Fönstret Systemegenskaper öppnas på fliken Avancerat. Välj Miljövariabler.

    Panelen Windows-systemegenskaper öppnas.

  4. I fönstret Miljövariabler går du till gruppen Systemvariabler , väljer raden Sökväg* och väljer sedan knappen Redigera .

    Fönstret miljövariabler med användar- och systemvariabler.

  5. Använd knapparna Flytta upp och Flytta ned för att flytta posten C:\Program Files\dotnet\ ovanför C:\Program Files (x86)\dotnet\.

    Listan med miljövariabler för systemet.

Det går långsammare att skapa appar än förväntat

Se till att Smart App Control, en Windows-funktion, är avstängd. Smart App Control rekommenderas inte att aktiveras på datorer som används för utveckling. Alla andra inställningar än "off" kan påverka SDK-prestanda negativt.

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

Installera Microsoft Visual C++ 2015-2019 Redistributable (64-bitars eller 32-bitars).