Instalowanie .NET na Windows

• Install on Windows
• Instalowanie w systemie macOS
• Instalowanie w systemie Linux

W tym artykule opisano, które wersje .NET są obsługiwane w Windows, sposobie instalowania .NET i różnicy między zestawem SDK i środowiskiem uruchomieniowym.

W przeciwieństwie do platformy .NET Framework .NET nie jest powiązana z twoją wersją Windows. Na Windows można zainstalować tylko jedną wersję programu .NET Framework. Ale .NET jest autonomiczny i można go zainstalować w dowolnym miejscu na komputerze. Niektóre aplikacje mogą zawierać własną kopię .NET.

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

Ważne

Jeśli instalujesz .NET w całym systemie, zainstaluj z uprawnieniami administracyjnymi.

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

Wybierz prawidłowe środowisko uruchomieniowe

Istnieją trzy różne środowiska uruchomieniowe dla 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 .NET:

Instalator	Obejmuje środowisko uruchomieniowe .NET	Obejmuje środowisko uruchomieniowe .NET Desktop	Obejmuje środowisko uruchomieniowe ASP.NET Core
.NET Runtime	Tak	Nie.	Nie.
.NET Desktop Runtime	Tak	Tak	Nie.
ASP.NET Core Runtime	Nie.	Nie.	Tak
zestaw SDK .NET	Tak	Tak	Tak

Aby upewnić się, że można uruchamiać wszystkie aplikacje .NET w 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 .NET Desktop Uruchamia aplikacje klasyczne, takie jak Windows Presentation Foundation (WPF) lub aplikacja Windows Forms.

Wybieranie sposobu instalowania .NET

Istnieją różne sposoby instalowania .NET, a niektóre produkty mogą zarządzać własną wersją .NET. Jeśli zainstalujesz .NET za pomocą oprogramowania, które zarządza własną wersją .NET, może nie być włączone dla całego systemu. Upewnij się, że rozumiesz konsekwencje instalowania .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 .NET.

Deweloperzy

• Visual Studio

  Użyj Visual Studio aby zainstalować .NET, gdy chcesz tworzyć aplikacje .NET przy użyciu Visual Studio. Visual Studio zarządza własną kopią .NET. Ta metoda instaluje zestaw SDK, środowisko uruchomieniowe i szablony Visual Studio.

• Visual Studio Code — C# Dev Kit

  Zainstaluj rozszerzenie C# Dev Kit dla Visual Studio Code w celu tworzenia aplikacji .NET. Rozszerzenie może używać zestawu SDK, który jest już zainstalowany lub zainstalować go za Ciebie.

Użytkownicy i deweloperzy

• Instalator .NET

  Zainstaluj .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.

• Windows Package Manager (WinGet)

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

• PowerShell

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

Obsługiwane wersje

Poniższa tabela zawiera listę aktualnie obsługiwanych wersji .NET i wersji Windows, na których są obsługiwane. Te wersje pozostają obsługiwane, dopóki wersja .NET nie osiągnie końca wsparcia lub wersji Windows osiągnie koniec życia.

Napiwek

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

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

System operacyjny	.NET 10 (architektury)	.NET 9 (architektury)	.NET 8 (architektury)
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 r. 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	✔️ x64, x86
Windows Server Core 2012 (i R2)	✔️ x64, x86	✔️ x64, x86	✔️ x64, x86
Nano Server (2025, 2022, 2019)	✔️ x64	✔️ x64	✔️ x64
Windows 8.1	❌	❌	❌
Windows 7 SP1 ESU	❌	❌	❌

Napiwek

+ Symbol reprezentuje minimalną wersję.

Windows 7 / 8.1 / Server 2012

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

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

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

System operacyjny	Wymagania wstępne
Windows 7 SP1 ESU	— Pakiet redystrybucyjny Microsoft Visual C++ 2015-2019 64-bitowy / 32-bitowy - KB3063858 64-bitowe / 32-bitowe - Microsoft Root Certificate Authority 2011 (tylko instalator offline .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 Windows oparte na usłudze Arm

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

Różnice ścieżki

Na komputerze Windows arm wszystkie wersje .NET arm64 są instalowane w normalnym folderze C:\Program Files\dotnet\. Jednak x64 wersja zestawu SDK .NET jest zainstalowana w folderze C:\Program Files\dotnet\x64\.

Zmienne ścieżki

Zmienne środowiskowe, które dodają .NET do ścieżki systemowej, takie jak zmienna PATH, może być konieczne zmianę, jeśli zainstalowano zarówno wersje x64, jak i Arm64 zestawu .NET SDK. Ponadto niektóre narzędzia korzystają z zmiennej środowiskowej DOTNET_ROOT, która również musi zostać zaktualizowana, aby wskazać odpowiedni folder instalacyjny zestawu SDK .NET.

Instalowanie przy użyciu Visual Studio

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

Pobierz instalatora Visual Studio

instalator Visual Studio instaluje i konfiguruje Visual Studio. Niektóre obciążenia Visual Studio obejmują .NET, takie jak ASP.NET i tworzenie aplikacji internetowych i .NET Tworzenie wieloplatformowego interfejsu użytkownika aplikacji. Określone wersje .NET można zainstalować za pomocą karty Individual Components.

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

• Install Visual Studio.
• Konfiguruj obciążenia Visual Studio.

zrzut ekranu

.NET wersje i Visual Studio

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

wersja zestawu SDK .NET	wersja Visual Studio
10	Visual Studio 2026 w wersji 18.0 lub nowszej.
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	Visual Studio 2022 w wersji 17.0 lub nowszej.
5	Visual Studio 2019 w wersji 16.8 lub nowszej.
3.1	Visual Studio 2019 w wersji 16.4 lub nowszej.
3.0	Visual Studio 2019 w wersji 16.3 lub nowszej.
2,2	Visual Studio 2017 w wersji 15.9 lub nowszej.
2.1	Visual Studio 2017 w wersji 15.7 lub nowszej.

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

1. Otwórz Visual Studio.
2. Wybierz Pomoc>Informacje o microsoft Visual Studio.
3. Przeczytaj numer wersji w oknie dialogowym Informacje .

Aby uzyskać więcej informacji, zobacz .NET SDK, MSBuild i Visual Studio przechowywanie wersji.

Instalowanie przy użyciu Visual Studio Code

Visual Studio Code to zaawansowany i lekki edytor kodu źródłowego, który działa na pulpicie. Visual Studio Code może używać zestawu SDK zainstalowanego już w systemie.

Ważne

Jeśli instalujesz .NET w całym systemie, zainstaluj z uprawnieniami administracyjnymi.

Ten plik konfiguracji WinGet instaluje najnowszy zestaw SDK .NET, Visual Studio Code i zestaw Deweloperski języka C#. Jeśli masz już jakiekolwiek z nich zainstalowane, usługa WinGet pominie ten krok.

1. Pobierz plik i kliknij dwukrotnie, aby go uruchomić.
2. Przeczytaj umowę licencyjną, wpisz yi wybierz pozycję Wprowadź po wyświetleniu monitu o zaakceptowanie.
3. Jeśli na pasku zadań zostanie wyświetlony monit kontroli konta użytkownika (UAC), zezwól na kontynuowanie instalacji.

Ponadto rozszerzenie C# Dev Kit zainstaluje .NET, jeśli nie jest jeszcze zainstalowane.

Aby uzyskać instrukcje dotyczące instalowania .NET za pośrednictwem Visual Studio Code, zobacz Pobierz wprowadzenie do języka C# w programie VS Code.

Instalator .NET

Strona download .NET udostępnia pliki wykonywalne instalatora Windows.

Ważne

Jeśli instalujesz .NET w całym systemie, zainstaluj z uprawnieniami administracyjnymi.

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

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

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

4. W kolumnie Installers0 znajdź wiersz 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.

   

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

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

   Zostanie otwarte okno dialogowe Instalatora Windows.

   

7. Wybierz Install i postępuj zgodnie z instrukcjami, aby zainstalować .NET.

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

Opcje wiersza polecenia

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

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

• /install
  Instaluje .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

Jeśli masz już zainstalowaną .NET, użyj Instalatora .NET do zarządzania instalacją. Zamiast /installużyj jednej z następujących opcji:

• /uninstall
  Usuń tę wersję .NET.

• /repair
  Sprawdź, czy kluczowe pliki lub składniki instalacji są uszkodzone i przywróć je.

Napiwek

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

Microsoft Update

Pliki wykonywalne instalatora .NET są niezależnymi produktami, które można obsługiwać przy użyciu usługi Microsoft Update (MU) w Windows. Funkcja MU różni się od 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 .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 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). Kiedy MU zostanie uruchomione, zaproponuje najnowszy instalator dla obu instalacji.

Blokowanie aktualizacji

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

wersja .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 Automatyczne aktualizacje. Systemy operacyjne serwera mogą zgłosić się do otrzymywania aktualizacji za pośrednictwem funkcji Automatyczne Aktualizacje przy użyciu następujących kluczy rejestru.

wersja .NET	Klucz rejestru	Nazwisko	Typ	Wartość
wszystkie	HKLM\SOFTWARE\Microsoft\.NET	Zezwól na AU na systemie operacyjnym serwera	REG_DWORD	0x00000001
.NET 9	HKLM\SOFTWARE\Microsoft\.NET\9.0	Zezwól na AU na systemie operacyjnym serwera	REG_DWORD	0x00000001
.NET 8	HKLM\SOFTWARE\Microsoft\.NET\8.0	Zezwól na AU na systemie operacyjnym serwera	REG_DWORD	0x00000001
.NET 7	HKLM\SOFTWARE\Microsoft\.NET\7.0	Zezwól na AU na systemie operacyjnym serwera	REG_DWORD	0x00000001
.NET 6	HKLM\SOFTWARE\Microsoft\.NET\6.0	Zezwól na AU na systemie operacyjnym serwera	REG_DWORD	0x00000001
.NET 5	HKLM\SOFTWARE\Microsoft\.NET\5.0	Zezwól na AU na systemie operacyjnym serwera	REG_DWORD	0x00000001
.NET Core 3.1	HKLM\SOFTWARE\Microsoft\.NET\3.1	Zezwól na AU na systemie operacyjnym serwera	REG_DWORD	0x00000001

WSUS i klasyfikacje aktualizacji

Program WSUS można skonfigurować tak, aby dostarczał określone aktualizacje na podstawie ich klasyfikacji. Aktualizacje .NET są klasyfikowane jako security lub krytyczne. Jeśli najnowsza aktualizacja jest klasyfikowana jako krytyczna, starsza security aktualizacja może być oferowana w przypadku zainstalowania starszej wersji .NET zastąpionej przez najnowszą aktualizację zabezpieczeń. Dotyczy to również skanowania maszyny przy użyciu pliku CAB w trybie offline (Wsusscan2.cab).

Uwaga

W niektórych przypadkach program WSUS może zgłosić brak aktualizacji wersji starszej niż zainstalowana wersja .NET. Załóżmy na przykład, że użytkownik instaluje .NET 6.0.36, najnowszą wersję .NET 6. Ta wersja jest klasyfikowana jako aktualizacja krytyczna (niezwiązana z zabezpieczeniami). Następnie aplikacja instaluje starszą wersję 6.0.33. (Nie jest rzadkością, aby aplikacje zawierały określone wersje .NET jako wymaganie wstępne). Jeśli administrator skonfigurował program WSUS tak, aby dostarczał tylko aktualizacje zabezpieczeń, następne skanowanie zgłosi błąd 6.0.35 jako brakującą aktualizację. Maszyny skonfigurowane do odbierania aktualizacji zabezpieczeń za pośrednictwem jednostek AU lub WSUS będą oferowane w wersji 6.0.35, nawet jeśli zainstalowano 6.0.36. Przyczyną jest to, że wersja 6.0.35 zastępuje 6.0.33 i jest najnowszą aktualizacją zabezpieczeń .

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 .NET, można określić, kiedy należy usunąć poprzednią instalację .NET przy użyciu klucza rejestru.

wersja .NET	Klucz rejestru	Nazwisko	Typ	Wartość
wszystkie	HKLM\SOFTWARE\Microsoft\.NET	UsuńPoprzedniąWersję	REG_SZ	always, never lub nextSession
.NET 10	HKLM\SOFTWARE\Microsoft\.NET\10.0	UsuńPoprzedniąWersję	REG_SZ	always, never lub nextSession
.NET 9	HKLM\SOFTWARE\Microsoft\.NET\9.0	UsuńPoprzedniąWersję	REG_SZ	always, never lub nextSession
.NET 8	HKLM\SOFTWARE\Microsoft\.NET\8.0	UsuńPoprzedniąWersję	REG_SZ	always, never lub nextSession

• never zachowuje poprzednie instalacje i wymaga ręcznej interwencji w celu usunięcia poprzednich instalacji .NET.
• always usuwa poprzednie instalacje po zainstalowaniu nowej wersji. Jest to domyślne zachowanie w .NET.
• nextSession odracza usunięcie do następnej sesji logowania dla członków grupy Administratorzy.
• Wartości są niewrażliwe na wielkość liter, a nieprawidłowe wartości domyślnie ustawiane są na 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 od wersji .NET 8 (8.0.11). Dotyczy tylko plików wykonywalnych autonomicznego instalatora i wpływa na dystrybucje, takie jak WinGet, które ich używają.

Instalowanie za pomocą Windows Package Manager (WinGet)

Możesz zainstalować .NET i zarządzać nią za pomocą usługi Windows Package Manager przy użyciu narzędzia winget.exe. 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.

Ważne

Jeśli instalujesz .NET w całym systemie, zainstaluj z uprawnieniami administracyjnymi.

Pakiety WinGet .NET to:

• Microsoft.DotNet.Runtime.10 — .NET Runtime 10.0
• Microsoft.DotNet.AspNetCore.10 — ASP.NET Core Runtime 10.0
• Microsoft.DotNet.DesktopRuntime.10 — środowisko uruchomieniowe .NET Desktop Runtime 10.0
• Microsoft.DotNet.SDK.10 — zestaw SDK .NET 10.0
• Microsoft.DotNet.Runtime.9 — .NET Runtime 9.0
• Microsoft.DotNet.AspNetCore.9 — ASP.NET Core Runtime 9.0
• Microsoft.DotNet.DesktopRuntime.9 — środowisko uruchomieniowe .NET Desktop Runtime 9.0
• Microsoft.DotNet.SDK.9 — zestaw SDK .NET 9.0
• Microsoft.DotNet.Runtime.8 — .NET Runtime 8.0
• Microsoft.DotNet.AspNetCore.8 — ASP.NET Core Runtime 8.0
• Microsoft.DotNet.DesktopRuntime.8 — środowisko uruchomieniowe .NET Desktop Runtime 8.0
• Microsoft.DotNet.SDK.8 — zestaw SDK .NET 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.10
   

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

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 PowerShell lub Wiersz polecenia.

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

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

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

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 .NET dostępne za pośrednictwem winGet:

winget search Microsoft.DotNet.SDK

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

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

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 .NET Desktop:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Instalowanie przy użyciu programu PowerShell

Instalowanie .NET za pomocą skryptu dotnet-install programu PowerShell jest zalecane w przypadku ciągłej integracji i instalacji nieadmin. Jeśli instalujesz .NET do normalnego użytku w systemie, użyj metod instalacji instalatora .NET lub Windows Package Manager.

Skrypt domyślnie instaluje najnowszą wersję long term support (LTS), która jest .NET 10. Możesz wybrać określoną wersję, określając -Channel przełącznik. Dołącz przełącznik -Runtime do instalacji środowiska uruchomieniowego. W przeciwnym razie skrypt instaluje zestaw SDK. Skrypt jest dostępny w https://dot.net/v1/dotnet-install.ps1, a kod źródłowy jest hostowany na GitHub.

Pobieranie skryptu

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

Instalowanie środowiska uruchomieniowego

Środowisko uruchomieniowe .NET jest instalowane przez udostępnienie 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 .NET, zobacz .NET omówienie interfejsu wiersza polecenia.

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 SDK .NET.

   dotnet-install.ps1
   

   Uwaga

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

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

Walidacja

Po pobraniu instalatora lub wydania binarnego sprawdź, czy plik nie został zmieniony ani uszkodzony. Możesz sprawdzić sumę kontrolną na swoim komputerze, a następnie porównać ją z tym, co zostało podane na stronie pobierania.

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

Możesz użyć PowerShell lub Wiersza polecenia, aby zweryfikować sumę kontrolną pobranego pliku. Na przykład, następujące polecenie wyświetla sumę kontrolną pliku dotnet-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

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

Aby zweryfikować, użyj programu PowerShell i pliku sumy kontrolnej.

Informacje o wersji .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 .NET instalacji:

1. Strona informacji o wersji dla .NET 9 w GitHub o https://github.com/dotnet/core/tree/main/release-notes/9.0 zawiera sekcję o nazwie Releases. Tabela w tej sekcji zawiera linki do plików pobierania i sumy kontrolnej dla każdej wersji .NET 9. Na poniższej ilustracji przedstawiono tabelę wersji .NET 8 jako odwołanie:

   

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

   Napiwek

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

3. Na stronie wydania można zobaczyć wersję zestawu .NET Runtime i .NET SDK oraz link do pliku sumy kontrolnej. Na poniższej ilustracji przedstawiono tabelę wersji .NET 8 jako odwołanie:

   

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://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt -OutFile 9.0.10-sha.txt
   

6. W przypadku zarówno pliku sumy kontrolnej, jak i pliku wydania .NET pobranego do tego samego katalogu, przeszukaj plik sumy kontrolnej dla sumy kontrolnej pobranej .NET:

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

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

   Jeśli zobaczysz 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 .NET poleceń interfejsu wiersza polecenia. Ta sekcja zbiera te typowe problemy i zawiera rozwiązania.

• No .NET SDK został znaleziony
• Tworzenie aplikacji jest wolniejsze niż oczekiwano
• hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll brakuje

Nie znaleziono zestawu SDK .NET

Najprawdopodobniej zainstalowano wersje x86 (32-bitowe) i x64 (64-bitowe) zestawu .NET SDK. Powoduje to konflikt, ponieważ po uruchomieniu polecenia dotnet jest rozpoznawana jako wersja x86, gdy powinna zostać rozpoznana jako wersja 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 Program Files (x86)\ folder jest pierwszy, jak pokazano w poniższym przykładzie, jest on 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
   

   Napiwek

   Mimo że Program Files jest używana w tym przykładzie, mogą zostać wyświetlone inne kopie dotnet.exe. Dostosuj je, aby najpierw zostały rozwiązane odpowiednie dotnet.exe.

   Jeśli jest to poprawne i Program Files\ najpierw nie masz problemu, który omawia ta sekcja i należy utworzyć .NET problem pomocy w GitHub.

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

   

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

   

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

   

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\.

   

Tworzenie aplikacji jest wolniejsze niż oczekiwano

Upewnij się, że funkcja Smart App Control, 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 jest brakujący

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

Powiązana zawartość

• omówienie interfejsu wiersza polecenia .NET
• Upgrade do nowej wersji .NET.
• Jak sprawdzić, czy .NET jest już zainstalowana.
• Samouczek: tworzenie nowej aplikacji konsolowej.