共用方式為


在 Ubuntu 上安裝 .NET SDK 或 .NET 執行階段

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

重要

.NET 10 已於 2025 年 11 月 11 日發行。 套件管理員摘要中或特定 Linux 散發套件可能需要一段時間才能包含套件。

如果您想要開發 .NET 應用程式,請安裝 SDK (其中包含執行階段)。 或者,如果您只需要執行應用程式,請安裝 Runtime。 如果您要安裝執行階段,建議您安裝 ASP.NET Core 執行階段,因為 .NET 和 ASP.NET Core 執行階段都包含在內。

使用 dotnet --list-sdksdotnet --list-runtimes 命令來查看已安裝的版本。 如需詳細資訊,請參閱如何檢查是否已安裝 .NET

重要

使用套件管理員從 Microsoft 套件摘要安裝 .NET,僅支援 x64 結構。 Microsoft 套件摘要不支援其他架構,例如 Arm64。 使用 Ubuntu 供應源 (feed) 或手動安裝 .NET。 使用多個供應源時要小心封包混合問題。 如需詳細資訊,請參閱 Linux 上的 .NET 套件混合

如需在沒有套件管理員的情況下安裝 .NET 的詳細資訊,請參閱下列其中一篇文章:

Ubuntu 25.10

.NET 可以在 Ubuntu 套件管理員存儲庫中使用。 Microsoft套件存放庫不再包含 Ubuntu 的 .NET 套件。

Ubuntu 25.10 支援或提供下列 .NET 版本:

支援的 .NET 版本 提供於
內建的 Ubuntu 訂閱源
可用於
backports(回溯移植)
Ubuntu 訊息來源
可用於
Microsoft 摘要
10.0, 9.0, 8.0 9.0, 8.0

當某個 Ubuntu 版本變成不支援時,該版本就不再支援 .NET。

重要

.NET 10 已於 2025 年 11 月 11 日發行。 套件管理員摘要中或特定 Linux 散發套件可能需要一段時間才能包含套件。

安裝 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 概觀

安裝執行階段

ASP.NET Core 執行階段可讓您執行使用未提供執行階段之 .NET 建立的應用程式。 下列命令會安裝 ASP.NET Core 執行階段,這是與 .NET 相容性最高的執行階段。 在終端機中執行下列命令:

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

ASP.NET Core 執行階段的替代方案是安裝 .NET 執行階段,後者不包含 ASP.NET Core 支援:將先前命令中的 aspnetcore-runtime-10.0 取代為 dotnet-runtime-10.0

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

若要了解如何使用 .NET CLI,請參閱 .NET CLI 概觀

相依性

當您使用套件管理員安裝時,系統會為您安裝這些程式庫。 不過,如果您手動安裝 .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 9.0, 8.0

當某個 Ubuntu 版本變成不支援時,該版本就不再支援 .NET。

重要

.NET 10 已於 2025 年 11 月 11 日發行。 套件管理員摘要中或特定 Linux 散發套件可能需要一段時間才能包含套件。

安裝 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 概觀

安裝執行階段

ASP.NET Core 執行階段可讓您執行使用未提供執行階段之 .NET 建立的應用程式。 下列命令會安裝 ASP.NET Core 執行階段,這是與 .NET 相容性最高的執行階段。 在終端機中執行下列命令:

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

ASP.NET Core 執行階段的替代方案是安裝 .NET 執行階段,後者不包含 ASP.NET Core 支援:將先前命令中的 aspnetcore-runtime-10.0 取代為 dotnet-runtime-10.0

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

若要了解如何使用 .NET CLI,請參閱 .NET CLI 概觀

相依性

當您使用套件管理員安裝時,系統會為您安裝這些程式庫。 不過,如果您手動安裝 .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 8.0 9.0, 7.0, 6.0

當某個 Ubuntu 版本變成不支援時,該版本就不再支援 .NET。

重要

.NET 10 已於 2025 年 11 月 11 日發行。 套件管理員摘要中或特定 Linux 散發套件可能需要一段時間才能包含套件。

.NET 可在 Ubuntu .NET backports 套件存放庫中取得。 若要新增存放庫,請開啟終端機並執行下列命令:

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 概觀

安裝執行階段

ASP.NET Core 執行階段可讓您執行使用未提供執行階段之 .NET 建立的應用程式。 下列命令會安裝 ASP.NET Core 執行階段,這是與 .NET 相容性最高的執行階段。 在終端機中執行下列命令:

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

ASP.NET Core 執行階段的替代方案是安裝 .NET 執行階段,後者不包含 ASP.NET Core 支援:將先前命令中的 aspnetcore-runtime-10.0 取代為 dotnet-runtime-10.0

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

若要了解如何使用 .NET CLI,請參閱 .NET CLI 概觀

相依性

當您使用套件管理員安裝時,系統會為您安裝這些程式庫。 不過,如果您手動安裝 .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 9.0 8.0、7.0、6.0、3.1

重要

如果您使用 .NET 8 SDK 和 Ubuntu 22.04,請瞭解 Canonical 所提供的 SDK 版本一律位於 .1xx 功能區段。 如果您想使用較新的 feature band 版本,請使用 Microsoft 資源庫來安裝 SDK。 請務必檢閱 .NET 套件在 Linux 上混合一文中的資訊,以了解在存放庫摘要之間切換的影響。

當某個 Ubuntu 版本變成不支援時,該版本就不再支援 .NET。

重要

.NET 10 已於 2025 年 11 月 11 日發行。 套件管理員摘要中或特定 Linux 散發套件可能需要一段時間才能包含套件。

.NET 可在 Ubuntu .NET backports 套件存放庫中取得。 若要新增存放庫,請開啟終端機並執行下列命令:

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 概觀

安裝執行階段

ASP.NET Core 執行階段可讓您執行使用未提供執行階段之 .NET 建立的應用程式。 下列命令會安裝 ASP.NET Core 執行階段,這是與 .NET 相容性最高的執行階段。 在終端機中執行下列命令:

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

ASP.NET Core 執行階段的替代方案是安裝 .NET 執行階段,後者不包含 ASP.NET Core 支援:將先前命令中的 aspnetcore-runtime-10.0 取代為 dotnet-runtime-10.0

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

若要了解如何使用 .NET CLI,請參閱 .NET CLI 概觀

相依性

當您使用套件管理員安裝時,系統會為您安裝這些程式庫。 不過,如果您手動安裝 .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 Core 3.1
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET 核心 2.0

如何安裝其他版本

.NET 套件名稱會跨所有 Linux 發行版本標準化。 下表列出套件:

所有 .NET 版本都可在 https://dotnet.microsoft.com/download/dotnet 下載,但需要手動安裝。 您可以嘗試使用套件管理員來安裝不同版本的 .NET。 不過,可能未提供您要求的版本。

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

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

    • dotnet
    • aspnetcore
  • 類型
    選擇 SDK 或執行階段。 有效的 選項如下:

    • sdk (僅適用於 dotnet 產品)
    • runtime
  • 版本
    要安裝的 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 相依性和需求

下一步