Udostępnij za pośrednictwem


Instalowanie platformy .NET w systemie Windows

W tym artykule opisano, które wersje platformy .NET są obsługiwane w systemie Windows, jak zainstalować platformę .NET i jaka jest różnica między zestawem SDK i środowiskiem uruchomieniowym.

W przeciwieństwie do programu .NET Framework platforma .NET nie jest powiązana z twoją wersją systemu Windows. W systemie Windows można zainstalować tylko jedną wersję programu .NET Framework. Platforma .NET jest autonomiczna i może być zainstalowana w dowolnym miejscu na komputerze. Niektóre aplikacje mogą zawierać własną kopię platformy .NET.

Domyślnie platforma .NET jest instalowana w katalogu Program Files\dotnet na komputerze, chyba że metoda instalacji wybierze inny katalog.

Platforma .NET składa się ze środowiska uruchomieniowego i zestawu SDK. Środowisko uruchomieniowe uruchamia aplikacje .NET, a zestaw SDK służy do tworzenia aplikacji.

Wybieranie prawidłowego środowiska uruchomieniowego

Istnieją trzy różne środowiska uruchomieniowe dla systemu Windows, które umożliwiają uruchamianie różnych typów aplikacji. Zestaw SDK zawiera wszystkie trzy środowiska uruchomieniowe, a instalator środowiska uruchomieniowego może zawierać dodatkowe środowisko uruchomieniowe. W poniższej tabeli opisano środowisko uruchomieniowe dołączone do określonego instalatora platformy .NET:

Instalator Obejmuje środowisko uruchomieniowe platformy .NET Obejmuje środowisko uruchomieniowe programu .NET Desktop Obejmuje ASP.NET Core Runtime
Środowisko uruchomieniowe platformy .NET Tak Nie. Nie.
Środowisko uruchomieniowe programu .NET Desktop Tak Tak Nie.
ASP.NET Core Runtime Nie Nie. Tak
Zestaw SDK platformy .NET Tak Tak Tak

Aby upewnić się, że można uruchamiać wszystkie aplikacje platformy .NET w systemie Windows, zainstaluj zarówno środowisko uruchomieniowe ASP.NET Core, jak i środowisko uruchomieniowe programu .NET Desktop. Środowisko uruchomieniowe ASP.NET Core uruchamia aplikacje internetowe, a środowisko uruchomieniowe pulpitu platformy .NET uruchamia aplikacje klasyczne, takie jak aplikacja Windows Presentation Foundation (WPF) lub Windows Forms.

Wybieranie sposobu instalowania platformy .NET

Istnieją różne sposoby instalowania platformy .NET, a niektóre produkty mogą zarządzać własną wersją platformy .NET. Jeśli zainstalujesz platformę .NET za pomocą oprogramowania, które zarządza własną wersją platformy .NET, może nie być włączone dla całego systemu. Upewnij się, że rozumiesz konsekwencje instalowania platformy .NET za pośrednictwem innego oprogramowania.

Jeśli nie masz pewności, którą metodę należy wybrać po przejrzeniu list w poniższych sekcjach, prawdopodobnie chcesz użyć Instalatora platformy .NET.

Deweloperzy

  • Program Visual Studio

    Użyj programu Visual Studio , aby zainstalować platformę .NET, gdy chcesz tworzyć aplikacje platformy .NET przy użyciu programu Visual Studio. Program Visual Studio zarządza własną kopią platformy .NET. Ta metoda instaluje szablony zestawu SDK, środowiska uruchomieniowego i programu Visual Studio.

  • Visual Studio Code — C# Dev Kit

    Zainstaluj rozszerzenie C# Dev Kit dla programu Visual Studio Code, aby tworzyć aplikacje platformy .NET. Rozszerzenie może używać zestawu SDK, który jest już zainstalowany lub instalowany.

Użytkownicy i deweloperzy

  • Instalator platformy .NET

    Zainstaluj platformę .NET przy użyciu pakietu Instalatora Windows, który jest plikiem wykonywalnym, który jest uruchamiany. Ta metoda umożliwia zainstalowanie zestawu SDK i środowiska uruchomieniowego. Instalacje są wykonywane w całym systemie.

  • Menedżer pakietów systemu Windows (WinGet)

    Użyj narzędzia WinGet , aby zainstalować platformę .NET, jeśli chcesz zarządzać platformą .NET za pośrednictwem wiersza polecenia. Ta metoda umożliwia zainstalowanie zestawu SDK i środowiska uruchomieniowego. Instalacje są wykonywane w całym systemie.

  • Program PowerShell

    Skrypt programu PowerShell, który może zautomatyzować instalację zestawu SDK lub środowiska uruchomieniowego. Możesz wybrać wersję platformy .NET do zainstalowania.

Obsługiwane wersje

Poniższa tabela zawiera listę aktualnie obsługiwanych wersji platformy .NET i obsługiwanych wersji systemu Windows. Te wersje pozostają obsługiwane, dopóki wersja platformy .NET nie osiągnie końca wsparcia lub wersja systemu Windows osiągnie koniec użytkowania.

Napiwek

Przypominamy, że ta tabela dotyczy nowoczesnej platformy .NET (w przeciwieństwie do platformy .NET Framework). Aby zainstalować program .NET Framework, zobacz przewodnik instalacji programu .NET Framework.

Daty zakończenia usługi systemu Windows 10 są podzielone według wersji. W poniższej tabeli uwzględniono tylko wersje Home, Pro, Pro Education i Pro for Workstations . Sprawdź arkusz informacyjny cyklu życia systemu Windows, aby uzyskać szczegółowe informacje.

System operacyjny .NET 9 (architektury) .NET 8 (architektury)
Windows 11 (24H2, 23H2, 22H2 Ent/Edu) ✔️ x64, x86, Arm64 ✔️ x64, x86, Arm64
Windows 10 (22H2+) ✔️ x64, x86, Arm64 ✔️ x64, x86, Arm64
Windows Server 2025
Windows Server 2022
Windows Server 2019
Windows Server, wersja 1903 lub nowsza
Windows Server 2016
Windows Server 2012 R2
Windows Server 2012
✔️ x64, x86 ✔️ x64, x86
Windows Server Core 2012 (i R2) ✔️ x64, x86 ✔️ x64, x86
Nano Server (2022, 2019) ✔️ x64 ✔️ x64
Windows 8.1
Windows 7 z dodatkiem SP1 ESU

Napiwek

+ Symbol reprezentuje minimalną wersję.

Windows 7/ 8.1 / Server 2012

Nie ma już wersji platformy .NET obsługiwanej w systemach Windows 7 i Windows 8.1. Ostatnie obsługiwane wersje to .NET 6 i wsparcie techniczne zakończyło się 12 listopada 2024 r.

System Windows Server 2012 jest nadal obsługiwany przez dowolną wersję platformy .NET, która jest nadal obsługiwana.

Wszystkie trzy z tych wersji systemu Windows wymagają zainstalowania dalszych zależności:

System operacyjny Wymagania wstępne
Windows 7 z dodatkiem SP1 ESU — Pakiet redystrybucyjny Microsoft Visual C++ 2015-2019 64-bitowy 32-bitowy /
- KB3063858 64-bitowe 32-bitowe /
- Główny urząd certyfikacji firmy Microsoft 2011 (tylko instalator offline platformy .NET Core 2.1)
Windows 8.1 Pakiet redystrybucyjny Microsoft Visual C++ 2015-2019 64-bitowy 32-bitowy /
Windows Server 2012 Pakiet redystrybucyjny Microsoft Visual C++ 2015-2019 64-bitowy 32-bitowy /
Windows Server 2012 R2 Pakiet redystrybucyjny Microsoft Visual C++ 2015-2019 64-bitowy 32-bitowy /

Poprzednie wymagania są również wymagane, jeśli wystąpi błąd związany z jedną z następujących bibliotek dll:

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

Komputery z systemem Windows oparte na usłudze Arm

Platforma .NET jest obsługiwana na komputerach z systemem Windows opartych na usłudze Arm. W poniższych sekcjach opisano kwestie, które należy wziąć pod uwagę podczas instalowania platformy .NET.

Różnice ścieżki

Na komputerze z systemem Windows opartym na usłudze Arm64 wszystkie wersje platformy .NET są instalowane w normalnym folderze C:\Program Files\dotnet\ . Jednak wersja x64 zestawu .NET SDK jest zainstalowana w folderze C:\Program Files\dotnet\x64\.

Zmienne ścieżki

Zmienne środowiskowe, które dodają platformę .NET do ścieżki systemowej, takie jak zmienna PATH , mogą być konieczne zmiany, jeśli masz zainstalowane wersje zestawu .NET SDK x64 i Arm64. Ponadto niektóre narzędzia korzystają ze zmiennej DOTNET_ROOT środowiskowej, która również musi zostać zaktualizowana w celu wskazania odpowiedniego folderu instalacyjnego zestawu .NET SDK.

Instalowanie za pomocą programu Visual Studio

Program Visual Studio instaluje własną kopię platformy .NET niezależnie od innych kopii platformy .NET. Różne wersje programu Visual Studio obsługują różne wersje platformy .NET. Najnowsza wersja programu Visual Studio zawsze obsługuje najnowszą wersję platformy .NET.

Instalator programu Visual Studio instaluje i konfiguruje program Visual Studio. Niektóre obciążenia programu Visual Studio obejmują platformę .NET, taką jak ASP.NET i tworzenie aplikacji internetowych oraz tworzenie wieloplatformowych interfejsów użytkownika aplikacji platformy .NET. Określone wersje platformy .NET można zainstalować na karcie Poszczególne składniki .

Dokumentacja programu Visual Studio zawiera instrukcje dotyczące wykonywania następujących czynności:

Zrzut ekranu przedstawiający Instalator programu Visual Studio z wyróżnionym obciążeniem programu .NET Desktop czerwonym polem.

Wersje platformy .NET i program Visual Studio

Jeśli używasz programu Visual Studio do tworzenia aplikacji platformy .NET, w poniższej tabeli opisano minimalną wymaganą wersję programu Visual Studio opartą na docelowej wersji zestawu .NET SDK.

Wersja zestawu .NET SDK Wersja programu Visual Studio
9 Visual Studio 2022 w wersji 17.12 lub nowszej.
8 Visual Studio 2022 w wersji 17.8 lub nowszej.
7 Visual Studio 2022 w wersji 17.4 lub nowszej.
6 Program Visual Studio 2022 w wersji 17.0 lub nowszej.
5 Visual Studio 2019 w wersji 16.8 lub nowszej.
3.1 Program Visual Studio 2019 w wersji 16.4 lub nowszej.
3.0 Program Visual Studio 2019 w wersji 16.3 lub nowszej.
2,2 Program Visual Studio 2017 w wersji 15.9 lub nowszej.
2.1 Program Visual Studio 2017 w wersji 15.7 lub nowszej.

Jeśli masz już zainstalowany program Visual Studio, możesz sprawdzić swoją wersję, wykonując następujące kroki.

  1. Otwórz program Visual Studio.
  2. Wybierz pozycję Pomoc>dotyczącą programu Microsoft Visual Studio.
  3. Przeczytaj numer wersji w oknie dialogowym Informacje .

Aby uzyskać więcej informacji na temat tego tematu, zobacz .NET SDK, MSBuild i Visual Studio versioning (Przechowywanie wersji w programie .NET SDK, MSBuild i Visual Studio).

Instalowanie za pomocą programu Visual Studio Code

Visual Studio Code to zaawansowany i lekki edytor kodu źródłowego, który działa na pulpicie. Program Visual Studio Code może używać zestawu SDK zainstalowanego już w systemie. Ponadto rozszerzenie zestawu deweloperskiego języka C# zainstaluje platformę .NET, jeśli nie jest jeszcze zainstalowane.

Aby uzyskać instrukcje dotyczące instalowania platformy .NET za pomocą programu Visual Studio Code, zobacz Wprowadzenie do języka C# w programie VS Code.

Instalator platformy .NET

Strona pobierania dla platformy .NET zawiera pliki wykonywalne Instalatora Windows.

  1. Otwórz przeglądarkę internetową i przejdź pod adres https://dotnet.microsoft.com/download/dotnet.

  2. Wybierz wersję platformy .NET, którą chcesz pobrać, na przykład 9.0.

  3. Znajdź pole SDK lub Runtime zawierające linki do pobierania platformy .NET.

  4. W kolumnie Instalatory znajdź wiersz systemu Windows i wybierz link dla architektury procesora CPU. Jeśli nie masz pewności, wybierz pozycję x64 , ponieważ jest to najbardziej typowe.

    Przeglądarka powinna automatycznie pobrać instalator.

    Napiwek

    Na poniższej ilustracji przedstawiono zestaw SDK, ale możesz również pobrać środowisko uruchomieniowe.

    Obraz strony pobierania platformy .NET z wyróżnionym linkiem pobierania zestawu SDK.

  5. Otwórz Eksploratora Windows i przejdź do lokalizacji, w której został pobrany plik, najprawdopodobniej do folderu Pobrane .

  6. Kliknij dwukrotnie plik, aby zainstalować program .NET.

    Zostanie otwarte okno dialogowe Instalatora Windows.

    Zrzut ekranu przedstawiający okno aplikacji instalatora platformy .NET.

  7. Wybierz pozycję Zainstaluj i postępuj zgodnie z instrukcjami, aby zainstalować platformę .NET.

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy .NET, zobacz Omówienie interfejsu wiersza polecenia platformy .NET.

Opcje wiersza polecenia

Użyj parametru , /? aby wyświetlić listę opcji.

Jeśli chcesz zainstalować platformę .NET w trybie dyskretnym, na przykład w środowisku produkcyjnym lub obsługiwać ciągłą integrację, użyj następujących opcji:

  • /install
    Instaluje platformę .NET.

  • /quiet
    Uniemożliwia wyświetlanie dowolnego interfejsu użytkownika i monitów.

  • /norestart
    Pomija wszelkie próby ponownego uruchomienia.

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

Napiwek

Instalator zwraca kod zakończenia 0 dla powodzenia i kod zakończenia 3010 , aby wskazać, że wymagane jest ponowne uruchomienie. Każda inna wartość jest najprawdopodobniej kodem błędu.

Microsoft Update

Pliki wykonywalne instalatora .NET to niezależne produkty, które można obsługiwać przy użyciu usługi Microsoft Update (MU) w systemie Windows. Usługa MU różni się od usługi Windows Update (WU), która jest używana do obsługi składników systemu operacyjnego, takich jak .NET Framework.

Zarówno poprawki zabezpieczeń, jak i niezwiązane z zabezpieczeniami dla obsługiwanych wersji platformy .NET są udostępniane za pośrednictwem mu przy użyciu wielu kanałów dystrybucji. Aktualizacje automatyczne (AU) są istotne dla użytkowników końcowych i użytkowników, podczas gdy usługi Windows Server Update Services (WSUS) i Wykaz usługi Windows Update są istotne dla administratorów IT.

Pliki wykonywalne instalatora .NET obsługują instalacje równoległe (SxS) w głównych i pomocniczych wersjach dla różnych architektur i składników, takich jak środowisko uruchomieniowe i zestaw SDK. Można na przykład zainstalować środowisko uruchomieniowe 6.0.15 (x64) i 6.0.17 (x86). Wyzwalacze MU oferują najnowszy instalator dla obu instalacji.

Blokowanie aktualizacji

Chociaż większość użytkowników woli być na bieżąco, istnieje możliwość blokowania aktualizacji platformy .NET przy użyciu kluczy rejestru w poniższej tabeli.

Wersja platformy .NET Klucz rejestru Nazwisko Typ Wartość
wszystkie 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

Aktualizacje automatyczne dla systemu operacyjnego serwera

Aktualizacje systemów operacyjnych serwera są obsługiwane przez programy WSUS i Microsoft Update Catalog, ale nie przez jednostki organizacyjne. Systemy operacyjne serwera mogą wyrazić zgodę na otrzymywanie aktualizacji za pośrednictwem jednostki organizacyjnej przy użyciu następujących kluczy rejestru.

Wersja platformy .NET Klucz rejestru Nazwisko Typ Wartość
wszystkie 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

Wybierz, kiedy poprzednie wersje zostaną usunięte

Pliki wykonywalne instalatora zawsze instalują nową zawartość przed usunięciem poprzedniej instalacji. Aplikacje, które są uruchomione, mogą zostać przerwane lub ulec awarii po usunięciu starszych środowisk uruchomieniowych. Aby zminimalizować wpływ aktualizacji platformy .NET, można określić, kiedy poprzednia instalacja platformy .NET powinna zostać usunięta przy użyciu klucza rejestru.

Wersja platformy .NET Klucz rejestru Nazwisko Typ Wartość
wszystkie HKLM\SOFTWARE\Microsoft\.NET RemovePreviousVersion REG_SZ always, never lub nextSession
.NET 9 HKLM\SOFTWARE\Microsoft\.NET\9.0 RemovePreviousVersion REG_SZ always, never lub nextSession
.NET 8 HKLM\SOFTWARE\Microsoft\.NET\8.0 RemovePreviousVersion REG_SZ always, never lub nextSession
  • never zachowuje poprzednie instalacje i wymaga ręcznej interwencji w celu usunięcia poprzednich instalacji platformy .NET.
  • always usuwa poprzednie instalacje po zainstalowaniu nowej wersji. Jest to domyślne zachowanie na platformie .NET.
  • nextSession usuwa usunięcie do następnej sesji logowania od członków w grupie Administratorzy.
  • Wartości są niewrażliwe na wielkość liter i są domyślnie nieprawidłowe wartości .always

Po odroczeniu usunięcia instalator zapisuje polecenie w kluczu rejestru RunOnce w celu odinstalowania poprzedniej wersji. Polecenie jest wykonywane tylko wtedy, gdy użytkownik w grupie Administratorzy zaloguje się do maszyny.

Uwaga

Ta funkcja jest dostępna tylko na platformie .NET 8 (8.0.11), 9 i nowszych wersjach platformy .NET. Dotyczy tylko plików wykonywalnych autonomicznego instalatora i wpływa na dystrybucje, takie jak WinGet, które ich używają.

Instalowanie za pomocą Menedżer pakietów systemu Windows (WinGet)

Platformę .NET można zainstalować i zarządzać nią za pomocą usługi Menedżer pakietów systemu Windows przy użyciu winget.exe narzędzia . Aby uzyskać więcej informacji na temat sposobu instalowania i używania narzędzia WinGet, zobacz Instalowanie aplikacji i zarządzanie nimi za pomocą narzędzia winget.

Jeśli instalujesz platformę .NET dla całego systemu, zainstaluj z uprawnieniami administracyjnymi.

Pakiety WinGet platformy .NET to:

  • 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

Instalacja zestawu SDK

Jeśli zainstalujesz zestaw SDK, nie musisz instalować odpowiedniego środowiska uruchomieniowego.

  1. Zainstaluj program WinGet.

  2. Otwórz terminal, taki jak program PowerShell lub wiersz polecenia.

  3. winget install Uruchom polecenie i przekaż nazwę pakietu SDK:

    winget install Microsoft.DotNet.SDK.9
    

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy .NET, zobacz Omówienie interfejsu wiersza polecenia platformy .NET.

Instalowanie środowiska uruchomieniowego

Istnieją różne środowiska uruchomieniowe, które można zainstalować. Zapoznaj się z sekcją Wybieranie poprawnego środowiska uruchomieniowego , aby dowiedzieć się, co jest zawarte w każdym środowisku uruchomieniowym.

  1. Zainstaluj program WinGet.

  2. Otwórz terminal, taki jak program PowerShell lub wiersz polecenia.

  3. winget install Uruchom polecenie i przekaż nazwę pakietu SDK:

    winget install Microsoft.DotNet.DesktopRuntime.9
    winget install Microsoft.DotNet.AspNetCore.9
    

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy .NET, zobacz Omówienie interfejsu wiersza polecenia platformy .NET.

Wyszukiwanie wersji

Użyj polecenia , winget search aby wyszukać różne wersje pakietu, który chcesz zainstalować. Na przykład następujące polecenie wyszukuje wszystkie zestawy SDK platformy .NET dostępne za pośrednictwem narzędzia WinGet:

winget search Microsoft.DotNet.SDK

Wyniki wyszukiwania są drukowane w tabeli z każdym identyfikatorem pakietu.

Name                           Id                           Version                    Source
----------------------------------------------------------------------------------------------
Microsoft .NET SDK 9.0         Microsoft.DotNet.SDK.9       9.0.100                    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

Instalowanie wersji zapoznawczych

Jeśli wersja zapoznawcza jest dostępna, zastąp numer wersji w identyfikatorze wyrazem Preview. W poniższym przykładzie jest instalowana wersja zapoznawcza środowiska uruchomieniowego programu .NET Desktop:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Instalowanie przy użyciu programu PowerShell

Instalowanie platformy .NET za pomocą skryptu dotnet-install programu PowerShell jest zalecane w przypadku ciągłej integracji i instalacji nieadmin. Jeśli instalujesz platformę .NET do normalnego użycia w systemie, użyj instalatora platformy .NET lub Menedżer pakietów systemu Windows metod instalacji.

Skrypt domyślnie instaluje najnowszą wersję wsparcia długoterminowego (LTS ), czyli platformę .NET 8. Możesz wybrać określoną wersję, określając -Channel przełącznik. Dołącz przełącznik, -Runtime aby zainstalować środowisko uruchomieniowe. W przeciwnym razie skrypt instaluje zestaw SDK. Skrypt jest dostępny pod adresem https://dot.net/v1/dotnet-install.ps1 i kod źródłowy jest hostowany w usłudze GitHub.

Aby uzyskać więcej informacji na temat skryptu, zobacz dotnet-install script reference (Dokumentacja skryptu dotnet-install).

Instalowanie środowiska uruchomieniowego

Środowisko uruchomieniowe platformy .NET jest instalowane przez podanie przełącznika -Runtime .

  1. Pobieranie skryptu instalacji z witryny https://dot.net/v1/dotnet-install.ps1

  2. Otwórz program PowerShell i przejdź do folderu zawierającego skrypt.

  3. Uruchom następujące polecenia, aby zainstalować środowisko uruchomieniowe pulpitu i środowisko uruchomieniowe ASP.NET Core w celu zapewnienia maksymalnej zgodności:

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

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy .NET, zobacz Omówienie interfejsu wiersza polecenia platformy .NET.

Instalacja zestawu SDK

Jeśli zainstalujesz zestaw SDK, nie musisz instalować środowisk uruchomieniowych.

  1. Pobieranie skryptu instalacji z witryny https://dot.net/v1/dotnet-install.ps1

  2. Otwórz program PowerShell i przejdź do folderu zawierającego skrypt.

  3. Uruchom następujące polecenie, aby zainstalować zestaw .NET SDK.

    dotnet-install.ps1
    

    Uwaga

    Zestaw SDK jest instalowany przez pominięcie przełącznika -Runtime .

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy .NET, zobacz Omówienie interfejsu wiersza polecenia platformy .NET.

Walidacja

Po pobraniu instalatora lub wydania binarnego sprawdź, czy plik nie został zmieniony ani uszkodzony. Możesz sprawdzić sumę kontrolną na komputerze, a następnie porównać ją z raportami w witrynie internetowej pobierania.

Po pobraniu pliku ze strony oficjalnego pobierania suma kontrolna pliku jest wyświetlana w polu tekstowym. Wybierz przycisk Kopiuj, aby skopiować wartość sumy kontrolnej do schowka.

Strona pobierania platformy .NET z sumą kontrolną

Możesz użyć programu PowerShell lub wiersza polecenia, aby zweryfikować sumę kontrolną pobranego pliku. Na przykład następujące polecenie zgłasza sumę kontrolną pliku 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

Porównaj sumę kontrolną z wartością podaną przez witrynę pobierania.

Sprawdzanie poprawności przy użyciu programu PowerShell i pliku sumy kontrolnej

Informacje o wersji platformy .NET zawierają link do pliku sumy kontrolnej, którego można użyć do zweryfikowania pobranego pliku. W poniższych krokach opisano sposób pobierania pliku sumy kontrolnej i weryfikowania pliku binarnego instalacji platformy .NET:

  1. Strona informacji o wersji dla platformy .NET 8 w witrynie GitHub zawiera https://github.com/dotnet/core/tree/main/release-notes/8.0 sekcję o nazwie Wydania. Tabela w tej sekcji zawiera linki do plików pobierania i sumy kontrolnej dla każdej wersji platformy .NET 8:

    Tabela wersji informacji o wersji usługi GitHub dla platformy .NET

  2. Wybierz link dla pobranej wersji platformy .NET. W poprzedniej sekcji użyto zestawu .NET SDK 8.0.100, który znajduje się w wersji .NET 8.0.0.

    Napiwek

    Jeśli nie masz pewności, która wersja platformy .NET zawiera plik sumy kontrolnej, zapoznaj się z linkami, dopóki nie znajdziesz go.

  3. Na stronie wydania zobaczysz wersję środowiska uruchomieniowego platformy .NET i zestawu .NET SDK oraz link do pliku sumy kontrolnej:

    Tabela pobierania z sumami kontrolnymi dla platformy .NET

  4. Skopiuj link do pliku sumy kontrolnej.

  5. Użyj następującego skryptu, ale zastąp link, aby pobrać odpowiedni plik sumy kontrolnej:

    Invoke-WebRequest https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt -OutFile 8.0.0-sha.txt
    
  6. W przypadku zarówno pliku sumy kontrolnej, jak i pliku wydania platformy .NET pobranego do tego samego katalogu, przeszukaj plik sumy kontrolnej dla sumy kontrolnej pobierania platformy .NET:

    Po pomyślnym zakończeniu walidacji zobaczysz wartość True wydrukowaną:

    > (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
    

    Jeśli zostanie wyświetlony komunikat Fałsz , pobrany plik nie jest prawidłowy i nie powinien być używany.

Rozwiązywanie problemów

Po zainstalowaniu zestawu .NET SDK mogą wystąpić problemy podczas próby uruchomienia poleceń interfejsu wiersza polecenia platformy .NET. Ta sekcja zbiera te typowe problemy i zawiera rozwiązania.

Nie znaleziono zestawu .NET SDK

Najprawdopodobniej zainstalowano wersje x86 (32-bitowe) i x64 (64-bitowe) zestawu .NET SDK. Powoduje to konflikt, ponieważ po uruchomieniu dotnet polecenia jest rozpoznawana wersja x86, gdy powinna zostać rozpoznana w wersji x64. Ten problem został rozwiązany przez dostosowanie zmiennej %PATH% , aby najpierw rozwiązać wersję x64.

  1. Sprawdź, czy masz zainstalowane obie wersje, uruchamiając where.exe dotnet polecenie . Jeśli tak, powinien zostać wyświetlony wpis dla folderów Program Files\ i Program Files (x86).\ Jeśli folder Program Files (x86)\ jest pierwszy, jak pokazano w poniższym przykładzie, jest niepoprawny i należy przejść do następnego kroku.

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

    Jeśli jest to poprawne, a program Files\ jest pierwszy, nie masz problemu, który omawia ta sekcja i należy utworzyć problem z żądaniem pomocy platformy .NET w usłudze GitHub

  2. Naciśnij przycisk Systemu Windows i wpisz "Edytuj zmienne środowiskowe systemu" w celu wyszukania. Wybierz pozycję Edytuj zmienne środowiskowe systemu.

    Menu Start systemu Windows z edytowaniem zmiennej środowiskowej

  3. Okno Właściwości systemu zostanie otwarte na karcie Zaawansowane. Wybierz pozycję Zmienne środowiskowe.

    Zostanie otwarty panel właściwości systemu Windows.

  4. W oknie Zmienne środowiskowe w grupie Zmienne systemowe wybierz wiersz Ścieżka*, a następnie wybierz przycisk Edytuj.

    Okno zmiennych środowiskowych ze zmiennymi użytkownika i systemu.

  5. Użyj przycisków Przenieś w górę i Przenieś w dół, aby przenieść wpis C:\Program Files\dotnet\ powyżej C:\Program Files (x86)\dotnet\.

    Lista zmiennych środowiskowych dla systemu.

Tworzenie aplikacji jest wolniejsze niż oczekiwano

Upewnij się, że funkcja Smart App Control, funkcja systemu Windows, jest wyłączona. Funkcja Smart App Control nie jest zalecana do włączania na maszynach używanych do programowania. Każde ustawienie inne niż "wyłączone" może negatywnie wpłynąć na wydajność zestawu SDK.

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

Zainstaluj pakiet redystrybucyjny Microsoft Visual C++ 2015-2019 (64-bitowy lub 32-bitowy).