在 Ubuntu 上安裝 .NET SDK 或 .NET 執行環境

本文討論如何在 Ubuntu 上安裝 .NET。

如果你想開發 .NET 應用程式，請安裝包含執行環境的 SDK。 或者，如果您只需要執行應用程式，請安裝 Runtime。 如果你正在安裝執行環境，我們建議你安裝 ASP.NET Core Runtime，因為它包含了 .NET 和 ASP.NET Core 的執行環境。

使用 dotnet --list-sdks 和 dotnet --list-runtimes 命令來查看已安裝的版本。 更多資訊請參閱 如何檢查.NET已安裝。

重要

使用套件管理器從 Microsoft 套件 feed 安裝 .NET 僅支援 x64 架構。 Microsoft 套件摘要不支援其他架構，例如 Arm64。 使用 Ubuntu 串流或手動安裝 .NET。 使用多個供應源時要小心封包混合問題。 欲了解更多資訊，請參閱 Linux 上的 .NET 套件混淆。

欲了解更多關於安裝 .NET 無套件管理器的資訊，請參閱以下文章之一：

Ubuntu 26.04

.NET 可以在 Ubuntu 套件管理器的資源庫中取得。 Microsoft 套件庫已不再包含 Ubuntu 的 .NET 套件。

Ubuntu 26.04 支援或可用的 .NET 版本如下：

支援的 .NET 版本 提供於
內建的 Ubuntu 訂閱源		 提供於
backports（回溯移植）
Ubuntu 訊息來源		 提供於
Microsoft 動態
10.0, 9.0, 8.0 10.0 9.0, 8.0 無

當 Ubuntu 版本停止支援時，該版本將不再支援.NET。

安裝 SDK

.NET SDK 允許你用 .NET 開發應用程式。 如果你安裝了 .NET SDK，就不需要安裝對應的執行環境。 要安裝 .NET SDK，請執行以下指令：

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

欲了解如何使用 .NET CLI，請參閱 .NET CLI overview。

安裝執行階段

ASP.NET Core 執行時允許你執行那些用 .NET 製作但沒有提供執行環境的應用程式。 以下指令可安裝 ASP.NET Core 執行環境，這是 .NET 最相容的執行環境。 在終端機中執行下列命令：

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

作為 ASP.NET Core 執行環境的替代方案，你可以安裝不包含 ASP.NET Core 支援的 .NET 執行環境：將前一個指令中的 aspnetcore-runtime-10.0 替換為 dotnet-runtime-10.0：

sudo apt-get install -y dotnet-runtime-10.0

欲了解如何使用 .NET CLI，請參閱 .NET CLI overview。

相依性

當您使用套件管理員安裝時，系統會為您安裝這些程式庫。 但如果你手動安裝 .NET 或發佈自成一體的應用程式，就必須確保這些函式庫已安裝：

  • 憑證授權管理
  • Libbrotli1
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • Libicu78
  • libssl3t64
  • libstdc++6
  • tzdata
  • zlib1g

您可以使用 apt install 命令來安裝相依性。 下列程式碼片段會示範如何安裝 zlib1g 程式庫：

sudo apt install zlib1g

Ubuntu 25.10

.NET 可以在 Ubuntu 套件管理器的資源庫中取得。 Microsoft 套件庫已不再包含 Ubuntu 的 .NET 套件。

Ubuntu 25.10 支援或可用的 .NET 版本如下：

支援的 .NET 版本 提供於
內建的 Ubuntu 訂閱源		 提供於
backports（回溯移植）
Ubuntu 訊息來源		 提供於
Microsoft 動態
10.0, 9.0, 8.0 10.0, 9.0, 8.0 無 無

當 Ubuntu 版本停止支援時，該版本將不再支援.NET。

安裝 SDK

.NET SDK 允許你用 .NET 開發應用程式。 如果你安裝了 .NET SDK，就不需要安裝對應的執行環境。 要安裝 .NET SDK，請執行以下指令：

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

欲了解如何使用 .NET CLI，請參閱 .NET CLI overview。

安裝執行階段

ASP.NET Core 執行時允許你執行那些用 .NET 製作但沒有提供執行環境的應用程式。 以下指令可安裝 ASP.NET Core 執行環境，這是 .NET 最相容的執行環境。 在終端機中執行下列命令：

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

作為 ASP.NET Core 執行環境的替代方案，你可以安裝不包含 ASP.NET Core 支援的 .NET 執行環境：將前一個指令中的 aspnetcore-runtime-10.0 替換為 dotnet-runtime-10.0：

sudo apt-get install -y dotnet-runtime-10.0

欲了解如何使用 .NET CLI，請參閱 .NET CLI overview。

相依性

當您使用套件管理員安裝時，系統會為您安裝這些程式庫。 但如果你手動安裝 .NET 或發佈自成一體的應用程式，就必須確保這些函式庫已安裝：

  • 憑證授權管理
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu76
  • libssl3t64
  • libstdc++6
  • tzdata
  • zlib1g

您可以使用 apt install 命令來安裝相依性。 下列程式碼片段會示範如何安裝 zlib1g 程式庫：

sudo apt install zlib1g

Ubuntu 25.04 版本

.NET 可以在 Ubuntu 套件管理器的資源庫中取得。 Microsoft 套件庫已不再包含 Ubuntu 的 .NET 套件。

Ubuntu 25.04 支援或可用的 .NET 版本如下：

支援的 .NET 版本 提供於
內建的 Ubuntu 訂閱源		 提供於
backports（回溯移植）
Ubuntu 訊息來源		 提供於
Microsoft 動態
10.0, 9.0, 8.0 10.0, 9.0, 8.0 無 無

當 Ubuntu 版本停止支援時，該版本將不再支援.NET。

安裝 SDK

.NET SDK 允許你用 .NET 開發應用程式。 如果你安裝了 .NET SDK，就不需要安裝對應的執行環境。 要安裝 .NET SDK，請執行以下指令：

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

欲了解如何使用 .NET CLI，請參閱 .NET CLI overview。

安裝執行階段

ASP.NET Core 執行時允許你執行那些用 .NET 製作但沒有提供執行環境的應用程式。 以下指令可安裝 ASP.NET Core 執行環境，這是 .NET 最相容的執行環境。 在終端機中執行下列命令：

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

作為 ASP.NET Core 執行環境的替代方案，你可以安裝不包含 ASP.NET Core 支援的 .NET 執行環境：將前一個指令中的 aspnetcore-runtime-10.0 替換為 dotnet-runtime-10.0：

sudo apt-get install -y dotnet-runtime-10.0

欲了解如何使用 .NET CLI，請參閱 .NET CLI overview。

相依性

當您使用套件管理員安裝時，系統會為您安裝這些程式庫。 但如果你手動安裝 .NET 或發佈自成一體的應用程式，就必須確保這些函式庫已安裝：

  • 憑證授權管理
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu76
  • libssl3t64
  • libstdc++6
  • tzdata
  • zlib1g

您可以使用 apt install 命令來安裝相依性。 下列程式碼片段會示範如何安裝 zlib1g 程式庫：

sudo apt install zlib1g

Ubuntu 24.04

.NET 可以在 Ubuntu 套件管理器的資源庫中取得。 Microsoft 套件庫已不再包含 Ubuntu 的 .NET 套件。

Ubuntu 24.04 支援或可用的 .NET 版本如下：

支援的 .NET 版本 提供於
內建的 Ubuntu 訂閱源		 提供於
backports（回溯移植）
Ubuntu 訊息來源		 提供於
Microsoft 動態
10.0, 9.0, 8.0 10.0, 8.0 9.0, 7.0, 6.0 無

當 Ubuntu 版本停止支援時，該版本將不再支援.NET。

安裝 SDK

.NET SDK 允許你用 .NET 開發應用程式。 如果你安裝了 .NET SDK，就不需要安裝對應的執行環境。 要安裝 .NET SDK，請執行以下指令：

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

欲了解如何使用 .NET CLI，請參閱 .NET CLI overview。

安裝執行階段

ASP.NET Core 執行時允許你執行那些用 .NET 製作但沒有提供執行環境的應用程式。 以下指令可安裝 ASP.NET Core 執行環境，這是 .NET 最相容的執行環境。 在終端機中執行下列命令：

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

作為 ASP.NET Core 執行環境的替代方案，你可以安裝不包含 ASP.NET Core 支援的 .NET 執行環境：將前一個指令中的 aspnetcore-runtime-10.0 替換為 dotnet-runtime-10.0：

sudo apt-get install -y dotnet-runtime-10.0

欲了解如何使用 .NET CLI，請參閱 .NET CLI overview。

相依性

當您使用套件管理員安裝時，系統會為您安裝這些程式庫。 但如果你手動安裝 .NET 或發佈自成一體的應用程式，就必須確保這些函式庫已安裝：

  • 憑證授權管理
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu74
  • libssl3t64
  • libstdc++6
  • tzdata
  • zlib1g

您可以使用 apt install 命令來安裝相依性。 下列程式碼片段會示範如何安裝 zlib1g 程式庫：

sudo apt install zlib1g

Ubuntu 22.04 版本

.NET 可在 Ubuntu 套件管理器的訂閱源以及 Microsoft 套件倉庫中取得。 不過，安裝 .NET 時，應該只用其中一種。 Microsoft建議您使用 Ubuntu 套件管理員來源。 如果您想要使用 Microsoft 套件存放庫，請參閱如何註冊 Microsoft 套件存放庫。

Ubuntu 22.04 支援或可用的 .NET 版本如下：

支援的 .NET 版本 提供於
內建的 Ubuntu 訂閱源		 提供於
.NET 回埠
Ubuntu 訊息來源		 提供於
Microsoft 動態
10.0, 9.0, 8.0 8.0、7.0、6.0 10.0, 9.0 8.0、7.0、6.0、3.1

重要

如果你使用的是 .NET 8 SDK 和 Ubuntu 22.04，請理解 Canonical 提供的 SDK 版本總是在 .1xx 功能頻段。 如果您想要使用較新的功能組版本，請使用 Microsoft 來源來安裝 SDK。 請務必查閱文章《Linux 上的 .NET 套件混淆》中的資訊，了解切換倉庫源的影響。

當 Ubuntu 版本停止支援時，該版本將不再支援.NET。

.NET 可在 Ubuntu .NET 反向移植套件庫取得。 若要新增存放庫，請開啟終端機並執行下列命令：

sudo add-apt-repository ppa:dotnet/backports

安裝 SDK

.NET SDK 允許你用 .NET 開發應用程式。 如果你安裝了 .NET SDK，就不需要安裝對應的執行環境。 要安裝 .NET SDK，請執行以下指令：

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

欲了解如何使用 .NET CLI，請參閱 .NET CLI overview。

安裝執行階段

ASP.NET Core 執行時允許你執行那些用 .NET 製作但沒有提供執行環境的應用程式。 以下指令可安裝 ASP.NET Core 執行環境，這是 .NET 最相容的執行環境。 在終端機中執行下列命令：

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

作為 ASP.NET Core 執行環境的替代方案，你可以安裝不包含 ASP.NET Core 支援的 .NET 執行環境：將前一個指令中的 aspnetcore-runtime-10.0 替換為 dotnet-runtime-10.0：

sudo apt-get install -y dotnet-runtime-10.0

欲了解如何使用 .NET CLI，請參閱 .NET CLI overview。

相依性

當您使用套件管理員安裝時，系統會為您安裝這些程式庫。 但如果你手動安裝 .NET 或發佈自成一體的應用程式，就必須確保這些函式庫已安裝：

  • 憑證授權管理
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu70
  • libssl3
  • libstdc++6
  • tzdata
  • zlib1g

您可以使用 apt install 命令來安裝相依性。 下列程式碼片段會示範如何安裝 zlib1g 程式庫：

sudo apt install zlib1g

不支援的版本

以下版本的 .NET 已不再支援 ❌：

  • .NET 7
  • .NET 6
  • .NET 5
  • .NET 核心 3.1
  • .NET 核心 3.0
  • .NET 核心 2.2
  • .NET 核心 2.1
  • .NET 核心 2.0

如何安裝其他版本

.NET 套件名稱在所有 Linux 發行版中皆有標準化。 下表列出套件：

所有版本的 .NET 皆可下載於 https://dotnet.microsoft.com/download/dotnet，但需手動安裝。 你可以試著用套件管理器安裝不同版本的 .NET。 不過，可能未提供您要求的版本。

新增至套件管理員源的套件會以可輕易修改的格式命名，例如：{product}-{type}-{version}。

  • 產品
    要安裝的 .NET 產品類型。 有效的 選項如下：

    • dotnet
    • aspnetcore

  • type
    選擇 SDK 或執行階段。 有效的 選項如下：

    • sdk (僅適用於 dotnet 產品)
    • runtime

  • version
    要安裝的 SDK 或執行階段版本。 有效選項是任何已發行的版本，例如：

    • 9.0
    • 8.0
    • 3.1
    • 2.1

    您嘗試下載的 SDK/執行階段可能不適用於您的 Linux 發行版本。 有關支援的發行版本清單，請參見 在 Linux 上安裝 .NET。

範例

  • 安裝 ASP.NET Core 9.0 執行環境：aspnetcore-runtime-9.0
  • 安裝 .NET Core 2.1 執行環境：dotnet-runtime-2.1
  • 安裝 .NET 5 SDK： dotnet-sdk-5.0
  • 安裝 .NET Core 3.1 SDK： dotnet-sdk-3.1

注意

您的 Linux 發行版本上可能未提供某些套件。

缺少套件

如果套件版本組合無法運作，則無法使用。 例如，沒有 ASP.NET Core SDK。 ASP.NET Core 的 SDK 元件包含在 .NET SDK 中。 aspnetcore-sdk-8.0 值不正確，應該是 dotnet-sdk-8.0。 關於 .NET 支援的 Linux 發行版列表，請參見 .NET 相依與需求。

下一步

  • Last updated on