在 Windows 上安裝 .NET

在本文中,您將瞭解如何在 Windows 上安裝 .NET。 .NET 是由執行時間和 SDK 所組成。 執行時間是用來執行 .NET 應用程式,而且可能未包含在應用程式內。 SDK 可用來建立 .NET 應用程式和程式庫。 .NET 執行階段一律會隨 SDK 一起安裝。

最新版的 .NET 為 7。

有兩種類型的支援版本:長期支援 (LTS) 版本或標準期限支援 (STS) 。 所有版本的品質都相同。 唯一的差異是支援長度。 LTS 版本可取得 3 年的免費支援和修補程式。 STS 版本可取得 18 個月的免費支援和修補程式。 如需詳細資訊,請參閱 .NET 支援原則

下表列出每個 .NET (版本和 .NET Core) 的支援狀態:

✔️ 支援 ❌ 支援
7 (STS) 5
6 (LTS) 3.0
3.1 (LTS) 2.2
2.1
2.0
1.1
1.0

使用 winget Windows 封裝管理員 () 安裝

您可以使用winget工具,透過 Windows 封裝管理員 服務來安裝和管理 .NET。 如需如何安裝和使用 winget的詳細資訊,請參閱 使用 winget 工具

如果您要安裝全 .NET 系統,請使用系統管理許可權進行安裝。

安裝 SDK

.NET SDK 可讓您使用 .NET 開發應用程式。 如果您安裝 .NET SDK,則不需要安裝對應的執行時間。 若要安裝 .NET SDK,請執行下列命令:

winget install Microsoft.DotNet.SDK.7

安裝執行階段

針對 Windows,您可以安裝三個 .NET 執行時間。 您應該同時安裝 .NET Desktop Runtime 和 ASP.NET Core Runtime,以確保您與所有類型的 .NET 應用程式相容。

  • .NET 桌面執行時間

    此執行時間包含基底 .NET 執行時間,並支援 Windows Presentation Foundation (使用 .NET 建置的 WPF) 和Windows Forms應用程式。 這與 Windows 隨附的.NET Framework不同。

    winget install Microsoft.DotNet.DesktopRuntime.7
    
  • ASP.NET Core執行時間

    此執行時間包含基底 .NET 執行時間,並執行 Web 服務器應用程式。 ASP.NET Core執行時間可讓您執行使用未提供執行時間的 .NET 所建立的應用程式。 下列命令會安裝 ASP.NET Core Runtime,這是 .NET 最相容的執行時間。 在您的終端機中,執行下列命令:

    winget install Microsoft.DotNet.AspNetCore.7
    
  • .NET 執行階段

    這是基底執行時間,只包含執行主控台應用程式所需的元件。 一般而言,您會安裝其他執行時間。

    winget install Microsoft.DotNet.Runtime.7
    

您可以藉由取代版本號碼來安裝執行時間的預覽版本,例如 6 ,其字為 Preview 。 下列範例會安裝 .NET Desktop Runtime 的預覽版本:

winget install Microsoft.DotNet.DesktopRuntime.Preview

與Visual Studio Code一起安裝

Visual Studio Code是在桌面上執行的強大且輕量型原始程式碼編輯器。 Visual Studio Code適用于 Windows、macOS 和 Linux。

雖然Visual Studio Code與 Visual Studio 一樣隨附自動化的 .NET Core 安裝程式,但新增 .NET Core 支援很簡單。

  1. 下載並安裝Visual Studio Code
  2. 下載並安裝 .NET SDK
  3. 從 Visual Studio Code Marketplace 安裝 C# 擴充功能

使用 Windows Installer 安裝

.NET 的 下載頁面 提供 Windows Installer 可執行檔。

當您使用 Windows 安裝程式來安裝 .NET 時,您可以藉由設定 DOTNETHOME_X64DOTNETHOME_X86 參數來自訂安裝路徑:

dotnet-sdk-7.0.100-win-x64.exe DOTNETHOME_X64="F:\dotnet\x64" DOTNETHOME_X86="F:\dotnet\x86"

如果您想要以無訊息方式安裝 .NET,例如在生產環境中或支援持續整合,請使用下列參數:

  • /install
    安裝 .NET。

  • /quiet
    防止任何 UI 和提示顯示。

  • /norestart
    抑制任何重新啟動嘗試。

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

如需詳細資訊,請參閱 標準安裝程式Command-Line選項

提示

安裝程式會傳回 0 的結束代碼以成功,而結束代碼為 3010,表示需要重新開機。 任何其他值通常是錯誤碼。

使用 PowerShell 自動化進行安裝

dotnet-install 腳本會用於執行時間的 CI 自動化和非系統管理員安裝。 您可以從 dotnet-install 腳本參考頁面下載腳本

腳本預設會安裝最新的 長期支援 (LTS) 版本,也就是 .NET 6。 您可以藉由指定 Channel 參數來選擇特定版本。 包含要安裝執行時間的 Runtime 參數。 否則,腳本會安裝 SDK。

下列命令會安裝 ASP.NET Core執行時間,以達到最大相容性。 ASP.NET Core執行時間也包含標準 .NET 執行時間。

dotnet-install.ps1 -Channel 7.0 -Runtime aspnetcore

省略 參數來 -Runtime 安裝 SDK。 這個 -Channel 範例中的 參數會設定為 STS ,它會安裝最新的標準字詞支援版本 (.NET 7) 。

dotnet-install.ps1 -Channel STS

使用 Visual Studio 安裝

如果您使用 Visual Studio 來開發 .NET 應用程式,下表會根據目標 .NET SDK 版本描述 Visual Studio 的最低必要版本。

.NET SDK 版本 Visual Studio 版本
7 Visual Studio 2022 17.4 版或更高版本。
6 Visual Studio 2022 17.0 版或更高版本。
5 Visual Studio 2019 16.8 版或更高版本。
3.1 Visual Studio 2019 16.4 版或更高版本。
3.0 Visual Studio 2019 16.3 版或更高版本。
2.2 Visual Studio 2017 15.9 版或更高版本。
2.1 Visual Studio 2017 15.7 版或更高版本。

如果您已安裝 Visual Studio,您可以使用下列步驟檢查您的版本。

  1. 開啟 Visual Studio。
  2. 選取[關於 Microsoft Visual Studio的說明> ]。
  3. 從 [ 關於 ] 對話方塊讀取版本號碼。

Visual Studio 可以安裝最新的 .NET SDK 和執行時間。

選取工作負載

安裝或修改 Visual Studio 時,請根據您要建置的應用程式類型,選取下列一或多個工作負載:

  • [其他工具組] 區段中的.NET Core 跨平臺開發工作負載。
  • Web 雲端一節中的&ASP.NET 和 Web 開發工作負載。
  • Web & 雲端一節中的Azure 開發工作負載。
  • Desktop Mobile 區段中的.NET 桌面&開發工作負載。

具有 .NET Core 工作負載的 Windows Visual Studio 2019

支援的版本

下表列出目前支援的 .NET 版本及其支援的 Windows 版本。 這些版本會維持支援狀態,直到 .NET 版本達到終止支援 ,或 Windows 版本達到生命週期結束為止。

Windows 10版本終止服務日期會依版本分割。 下表只考慮家用版、專業版、專業教育版和工作站專業版 如需特定詳細資料,請查看 Windows 生命週期事實表

提示

+符號代表最低版本。

作業系統 .NET 7 .NET 6 .NET Core 3.1
Windows 11 ✔️ ✔️ ✔️
Windows Server 2022 ✔️ ✔️ ✔️
Windows Server 版本 1903 或更新版本 ✔️ ✔️ ✔️
Windows 10,版本 1607 或更新版本 ✔️ ✔️ ✔️
Windows 8.1 ✔️ ✔️
Windows 7 SP1 ESU ✔️ ✔️
Windows Server 2019
Windows Server 2016
Windows Server 2012 R2
Windows Server 2012
✔️ ✔️
Windows Server Core 2012 R2 ✔️ ✔️ ✔️
Windows Server Core 2012 ✔️ ✔️ ✔️
Nano Server 版本 1809+ ✔️ ✔️ ✔️
Nano Server 版本 1803 ✔️

如需 .NET 7 支援的作業系統、發行版本和生命週期原則的詳細資訊,請參閱 .NET 7 支援的作業系統版本

不支援的版本

不再支援下列 .NET ❌ 版本:

  • .NET 5
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

執行時間資訊

執行時間用來執行以 .NET 建立的應用程式。 當應用程式作者發佈應用程式時,他們可以將其應用程式包含執行時間。 如果未包含執行時間,則由使用者安裝執行時間。

您可以在 Windows 上安裝三個不同的執行時間:

  • ASP.NET Core執行時間
    執行 ASP.NET Core應用程式。 包含 .NET 執行時間。

  • 桌面執行時間
    執行適用于 Windows 的 .NET WPF 和Windows Forms傳統型應用程式。 包含 .NET 執行時間。

  • .NET 執行時間
    此執行時間是最簡單的執行時間,不包含任何其他執行時間。 強烈建議您同時安裝ASP.NET Core 運行時間和桌面運行時間,以獲得最佳與 .NET 應用程式的相容性。

SDK 資訊

SDK 可用來建置和發佈 .NET 應用程式和程式庫。 安裝 SDK 包含這三個執行時間:ASP.NET Core、桌面和 .NET。

Arm 型 Windows 電腦

下列各節說明在 Arm 型 Windows 電腦上安裝 .NET 時應考慮的事項。

支援的項目

下表說明 Arm 型 Windows 電腦上支援哪些 .NET 版本:

.NET 版本 架構 SDK 執行階段 路徑衝突
7 Arm64
7 x64
6 Arm64
6 x64
5 Arm64
5 x64
3.1 Arm64 N/A
3.1 x64

從 .NET 6 開始,.NET SDK 的 x64 和 Arm64 版本彼此獨立存在。 如果發行新版本,則必須升級每個架構安裝。

路徑差異

在 Arm 型 Windows 電腦上,所有 Arm64 版本的 .NET 都會安裝到一般的 C:\Program Files\dotnet\ 資料夾。 不過,當您安裝 .NET 64 SDK 或 .NET 7 SDK 的 x64 版本時,它會安裝到 C:\Program Files\dotnet\x64\ 資料夾。

路徑衝突

從 .NET 6 開始, x64 .NET SDK 會安裝到自己的目錄,如上一節所述。 這可讓 .NET SDK 的 Arm64 和 x64 版本存在於相同的電腦上。 不過,不支援任何 64 之前的 x64 SDK,並安裝到與 Arm64 版本相同的位置 ,也就是 C:\Program Files\dotnet\ 資料夾。 如果您想要安裝不支援的 x64 SDK,您必須先卸載 Arm64 版本。 相反地,您也需要卸載不支援的 x64 SDK 才能安裝 Arm64 版本。

路徑變數

如果您同時安裝了 .NET 和 Arm64 版本的 .NET SDK,則可能需要變更將 .NET 新增至系統路徑的 PATH 環境變數,例如 變數。 此外,某些工具依賴 DOTNET_ROOT 環境變數,這也需要更新,才能指向適當的 .NET SDK 安裝資料夾。

相依性

.NET 7 支援下列 Windows 版本:

注意

+符號代表最低版本。

OS 版本 架構
Windows 11 21H2+ x64、Arm64
Windows 10 用戶端 1607+ x64、x86、Arm64
Windows 用戶端 7 SP1+、8.1 x64、x86
Windows Server 2012+ x64、x86
Windows Server Core 2012+ x64、x86
Nano Server 1809+ x64

如需 .NET 7 支援的作業系統、發行版本和生命週期原則的詳細資訊,請參閱 .NET 7 支援的作業系統版本

Windows 7 / Vista / 8.1 / Server 2008 R2 / Server 2012 R2

如果您要在下列 Windows 版本上安裝 .NET SDK 或執行時間,則需要更多相依性:

作業系統 Prerequisites
Windows 7 SP1 ESU - Microsoft Visual C++ 2015-2019 可轉散發套件 64 位 / 32 位
- KB3063858 64 位 / 32 位
- Microsoft 根憑證授權單位 2011 (.NET Core 2.1 離線安裝程式僅)
Windows Vista SP 2 Microsoft Visual C++ 2015-2019 可轉散發套件 64 位 / 32 位
Windows 8.1 Microsoft Visual C++ 2015-2019 可轉散發套件 64 位 / 32 位
Windows Server 2008 R2 Microsoft Visual C++ 2015-2019 可轉散發套件 64 位 / 32 位
Windows Server 2012 Microsoft Visual C++ 2015-2019 可轉散發套件 64 位 / 32 位
Windows Server 2012 R2 Microsoft Visual C++ 2015-2019 可轉散發套件 64 位 / 32 位

如果您收到與下列其中一個 dll 相關的錯誤,也需要先前的需求:

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

Docker

容器提供輕量型的方式來隔離應用程式與主機系統的其餘部分。 相同電腦上的容器只會共用核心,並使用提供給您的應用程式的資源。

.NET 可以在 Docker 容器中執行。 官方 .NET Docker 映射會發佈至 Microsoft Container Registry (MCR) ,而且可在Microsoft .NET Docker Hub 存放庫探索。 每個存放庫都包含您可以使用的 .NET (SDK 或執行階段) 與作業系統不同組合的映像。

Microsoft 會提供針對特定案例量身訂做的映像。 例如,ASP.NET Core 存放庫 \(英文\) 可提供為了在生產環境中執行 ASP.NET Core 應用程式而建置的映像。

如需在 Docker 容器中使用 .NET 的詳細資訊,請參閱.NET 和 Docker 和範例簡介。

疑難排解

安裝 .NET SDK 之後,您可能會遇到嘗試執行 .NET CLI 命令的問題。 本節會收集這些常見問題並提供解決方案。

找不到任何已安裝的 .NET Core SDK

您最有可能同時安裝 x86 (32 位) 和 x64 (64 位) 版本的 .NET SDK。 這會導致衝突,因為當您執行 dotnet 命令時,它會在應該解析為 x64 版本時解析為 x86 版本。 這通常是藉由調整 %PATH% 變數來先解析 x64 版本來修正。

  1. 執行 命令來確認您已安裝這兩個版本 where.exe dotnet 。 如果您這麼做,您應該會看到 Program Files\Program Files (x86) \ 資料夾的專案。 如果 Program Files (x86) \ 資料夾先如下列範例所示,則不正確,您應該繼續進行下一個步驟。

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

    如果正確且 Program Files\ 是第一個,則本節未討論問題,您應該 在 GitHub 上建立 .NET 說明要求問題

  2. 按 [Windows] 按鈕,然後輸入 「編輯系統內容變數」進行搜尋。 選取 [編輯系統內容變數]。

    具有編輯環境變數的 Windows 開始功能表

  3. [ 系統屬性 ] 視窗隨即開啟至 [ 進階] 索引標籤。選取 [環境變數]。

    Windows 系統屬性面板隨即開啟。

  4. 在 [ 環境變數] 視窗的 [ 系統變數 ] 群組底下,選取 [路徑*] 資料列,然後選取 [ 編輯] 按鈕。

    具有使用者和系統變數的環境變數視窗。

  5. 使用 [上移 ] 和 [ 下移 ] 按鈕,將 C:\Program Files\dotnet\ 專案移至 C:\Program Files (x86) \dotnet\

    系統的環境變數清單。

下一步