使用 Snap 安裝 .NET 執行階段

本文描述如何安裝 .NET 執行階段 Snap 套件。 .NET 執行階段 Snap 套件是由 Canonical 提供和維護。 Snap 是 Linux 發行版本內建套件管理員的絕佳替代方案。 如果您需要安裝 SDK,請參閱 使用 Snap 安裝 .NET SDK。

Snap 是應用程式及其相依性的套件組合,可在許多不同的 Linux 發行版本上運作。 您可從 Snap Store 探索和安裝 Snap。 欲了解更多關於 Snap 的資訊,請參閱 「開始」。

警告

.NET 的 Snap 安裝可能有執行 .NET 工具的問題。 如果您想要使用 .NET 工具,建議您針對特定 Linux 發行版本使用 dotnet-install 指令碼或套件管理員來安裝 .NET。

必要條件

  • 支援 Snap 的 Linux 發行版本。
  • snapd Snap 常駐程式。

您的 Linux 發行版本可能已包含 Snap。 請嘗試從終端執行 snap,以查看命令是否正常運作。 如需支援的 Linux 發行版本清單,以及如何安裝 Snap 的指示,請參閱安裝 snapd。

.NET 發行版本

Microsoft 會在兩個不同的支援原則下發佈 .NET:長期支援 (LTS) 和標準期限支援 (STS)。 所有版本的品質都一樣。 唯一的差異是支援的時間長度。 LTS 版本提供 3 年的免費支援和修補程式。 STS 版本可獲得兩年的免費支援和修補程式。 如需詳細資訊,請參閱 .NET 支援原則 (英文)。

Microsoft 目前支援的 .NET 版本如下:

  • 11.0(STS)—支援將於 2028 年 11 月 14 日 到期。
  • 10.0 (LTS) — 支援將於 2028 年 11 月 14 日結束。

其他建置和發行 .NET 的實體可能會引入不同的支援原則。 請務必洽詢這些實體,以瞭解對 .NET 的支援方式。

1.安裝執行階段

安裝 .NET 10 執行階段 snap 套件的步驟如下:

  1. 開啟終端機。

  2. 使用 snap install 安裝 .NET 執行階段 Snap 套件。 例如,以下指令會安裝 .NET 10 執行環境。

    sudo snap install dotnet-runtime-100
    

每個 .NET 執行階段都發佈為個別的 snap 套件。 下表列出套件:

.NET 版本 Snap 套件 Microsoft 支援 .NET 版本
11(STS) dotnet-runtime-110 是的
10(LTS) dotnet-runtime-100 是的
9(STS) dotnet-runtime-90 否
8(LTS) dotnet-runtime-80 否
7(STS) dotnet-runtime-70 否
6(LTS) dotnet-runtime-60 否
5 dotnet-runtime-50 否
3.1 dotnet-runtime-31 否
3.0 dotnet-runtime-30 否
2.2 dotnet-runtime-22 否
2.1 dotnet-runtime-21 否

2.啟用 dotnet 命令

因為 Snap 不會建立未帶版本號的 dotnet 指令,請建立符號連結,讓 dotnet 可供整個系統使用。 只有當你想將指令映射 dotnet 到這個特定的 Snap 安裝時,才建立這個連結。 如果 /usr/local/bin/dotnet 已存在,請在建立連結前將其移除;否則,ln -s 會失敗。

sudo ln -s /snap/dotnet-runtime-100/current/usr/bin/dotnet /usr/local/bin/dotnet

某些執行時快照為了向後相容性,會提供 dotnet 應用程式。 例如,使用 dotnet-runtime-80,您可以改為啟用未版本化指令,並使用:

sudo snap alias dotnet-runtime-80.dotnet dotnet

僅包含內容的 snap,例如 dotnet-runtime-90、dotnet-runtime-100 和 dotnet-runtime-110,不會提供 dotnet app。 對於這些套件,請使用前述的符號連結指令。

3.匯出安裝位置

DOTNET_ROOT 環境變數通常由工具用來判斷安裝 .NET 的位置。 透過 Snap 安裝 .NET 時,不會設定此環境變數。 您應該在設定檔中設定 DOTNET_ROOT 環境變數。 路徑格式如下: /snap/{package}/current/usr/lib/dotnet。 例如,如果您安裝了 dotnet-runtime-100 Snap,請使用下列命令將環境變數設定為 .NET 所在的位置:

export DOTNET_ROOT=/snap/dotnet-runtime-100/current/usr/lib/dotnet

永久匯出環境變數

上述 export 命令只會設定其執行所在終端機工作階段的環境變數。

您可以編輯 Shell 設定檔,永久新增命令。 有多種不同的 Shell 適用於 Linux,且每個 Shell 都有不同的環境配置。 例如:

  • Bash Shell: ~/.bash_profile, ~/.bashrc
  • Korn Shell: ~/.kshrc 或 .profile
  • Z Shell: ~/.zshrc 或 .zprofile

編輯適合您的命令行的原始檔案,然後添加 export DOTNET_ROOT=/snap/dotnet-runtime-100/current/usr/lib/dotnet。

疑難排解

dotnet 終端命令無作用

僅內容的 .NET 執行階段快照,包括 dotnet-runtime-90、dotnet-runtime-100 和 dotnet-runtime-110,不會建立未版本化的 dotnet 指令。 要讓此 dotnet 指令可用,請在快照封包中建立指向 dotnet 可執行檔的符號連結:

sudo ln -s /snap/dotnet-runtime-100/current/usr/bin/dotnet /usr/local/bin/dotnet

以執行階段套件的名稱取代 dotnet-runtime-100。 如果 /usr/local/bin/dotnet 已經存在,請在建立連結前移除。

對於會提供 dotnet 應用程式的執行階段 snap(例如 dotnet-runtime-80),你可以改用 snap alias:

sudo snap alias dotnet-runtime-80.dotnet dotnet

無法在 WSL2 上安裝 Snap

systemd 必須在 WSL2 實例上啟用,才能安裝 Snap。

  1. 以選擇的文字編輯器開啟 /etc/wsl.conf。

  2. 貼入下列配置:

    [boot]
    systemd=true
    
  3. 儲存檔案,並透過 PowerShell 重新啟動 WSL2 執行個體。 使用 wsl.exe --shutdown 命令。

4.使用 .NET CLI

開啟終端機並輸入 dotnet。

dotnet

您會看到類似下方的輸出:

Usage: dotnet [options]
Usage: dotnet [path-to-application]

Options:
  -h|--help         Display help.
  --info            Display .NET information.
  --list-sdks       Display the installed SDKs.
  --list-runtimes   Display the installed runtimes.

path-to-application:
  The path to an application .dll file to execute.

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