本文討論如何在 Ubuntu 上安裝 .NET。
重要
.NET 10 已於 2025 年 11 月 11 日發行。 套件管理員摘要中或特定 Linux 散發套件可能需要一段時間才能包含套件。
如果您想要開發 .NET 應用程式,請安裝 SDK (其中包含執行階段)。 或者,如果您只需要執行應用程式,請安裝 Runtime。 如果您要安裝執行階段,建議您安裝 ASP.NET Core 執行階段,因為 .NET 和 ASP.NET Core 執行階段都包含在內。
使用 dotnet --list-sdks 和 dotnet --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 產品類型。 有效的 選項如下:dotnetaspnetcore
類型
選擇 SDK 或執行階段。 有效的 選項如下:-
sdk(僅適用於 dotnet 產品) runtime
-
版本
要安裝的 SDK 或執行階段版本。 有效選項是任何已發行的版本,例如:9.08.03.12.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 相依性和需求。