共用方式為


使用 Snap 安裝 .NET SDK

本文描述如何安裝 .NET SDK Snap 套件。 .NET SDK Snap 套件是由 Canonical 提供和維護。 Snap 是 Linux 發行版本內建套件管理員的絕佳替代方案。

Snap 是應用程式及其相依性的套件組合,可在許多不同的 Linux 發行版本上運作。 您可從 Snap Store 探索和安裝 Snap。 如需 Snap 的詳細資訊,請參閱 Snap 使用者入門

警告

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

這是透過 Snap 安裝 .NET 時,dotnet watch 命令無法運作的已知問題。

如果您即將使用 .NET 工具或 dotnet watch 命令,建議您使用 dotnet-install 指令碼來安裝 .NET。

必要條件

  • 支援 Snap 的 Linux 發行版本。
  • 對 Snap 精靈執行 snapd

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

.NET 版本

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

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

  • 8.0 (LTS)—支援將於 2026 年 11 月 10 日結束。
  • 6.0 (LTS)—支援將於 2024 年 11 月 12 日結束。

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

1.安裝 SDK

.NET SDK 的 Snap 套件全都以相同的識別碼發佈:dotnet-sdk。 您可藉由指定通道來安裝特定版本的 SDK。 SDK 包含 ASP.NET Core 和 .NET 執行階段,版本與 SDK 一致。

提示

Snapcraft .NET SDK 套件頁面包含如何安裝 Snapcraft 和 .NET 的發行版本特定指示。

  1. 開啟終端機。

  2. 使用 snap install 安裝 .NET SDK Snap 套件。 例如,下列命令會安裝預設 latest/stable 通道。

    sudo snap install dotnet-sdk --classic
    
    • --classic 是必要參數。
    • 使用 --channel 參數來指定要安裝的版本。 如果省略此參數,則會使用 latest/stable。 例如,--channel 8.0/stable 會安裝 .NET SDK 8.0。

系統會自動建立 dotnet Snap 別名,並對應至 Snap 套件的 dotnet 命令。

下表列出您可以安裝的套件通道:

.NET 版本 Snap 套件通道
8 (LTS) 8.0/stable
latest/stable
lts/stable
7 7.0/stable (不支援)
6 (LTS) 6.0/stable
5 5.0/stable (不支援)
3.1 3.1/stable (不支援)
2.1 2.1/stable (不支援)

2.匯出安裝位置

DOTNET_ROOT 環境變數通常由工具用來判斷安裝 .NET 的位置。 透過 Snap 安裝 .NET 時,不會設定此環境變數。 您應該在設定檔中設定 DOTNET_ROOT 環境變數。 Snap 的路徑使用下列格式:/snap/{package}/current

export DOTNET_ROOT=/snap/dotnet-sdk/current

永久匯出環境變數

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

您可以編輯殼層設定檔,永久新增命令。 有許多不同殼層可供 Linux 使用,且每個殼層都有不同的設定檔。 例如:

  • Bash 殼層~/.bash_profile~/.bashrc
  • Korn 殼層~/.kshrc.profile
  • Z 殼層:_~/.zshrc* or .zprofile

編輯殼層的適當原始程式檔,並新增 export DOTNET_ROOT=/snap/dotnet-sdk/current

3.使用 .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 概觀

疑難排解

dotnet 終端命令無作用

Snap 套件可以將別名對應至套件所提供的命令。 根據預設,.NET SDK Snap 套件會建立 dotnet 命令的別名。 如果未建立或先前移除了別名,下列命令會顯示如何對應別名:

sudo snap alias dotnet-sdk.dotnet dotnet

無法在 WSL2 上安裝 Snap

必須先在 WSL2 執行個體上啟用 systemd,才能安裝 Snap。

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

  2. 貼上下列組態:

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

無法解析 dotnet 命令或 SDK

其他應用程式 (例如 Visual Studio Code 中的程式碼 IDE 或延伸模組) 嘗試解析 .NET SDK 的位置很常見。 一般而言,探索的進行方式是檢查 DOTNET_ROOT 環境變數,或找出 dotnet 可執行檔所在的位置。 已安裝 Snap 的 .NET SDK 可能讓這些應用程式混淆。 當這些應用程式無法解析 .NET SDK 時,就會顯示類似下列其中一則訊息的錯誤:

  • 找不到指定的 SDK 'Microsoft.NET.Sdk'
  • 找不到指定的 SDK 'Microsoft.NET.Sdk.Web'
  • 找不到指定的 SDK 'Microsoft.NET.Sdk.Razor'

請嘗試下列步驟來修正此問題:

  1. 確定您永久匯出 DOTNET_ROOT 環境變數

  2. 嘗試以符號將 Snap dotnet 可執行檔連結到程式要尋找的位置。

    dotnet 命令正在尋找的兩個常見路徑如下:

    • /usr/local/bin/dotnet
    • /usr/share/dotnet

    使用下列命令來建立 Snap 套件的符號連結:

    ln -s /snap/dotnet-sdk/current/dotnet /usr/local/bin/dotnet
    

TLS/SSL 憑證錯誤

透過 Snap 安裝 .NET 時,在某些發行版本上可能找不到 .NET TLS/SSL 憑證,而且您可能在 restore 期間收到錯誤:

Processing post-creation actions...
Running 'dotnet restore' on /home/myhome/test/test.csproj...
  Restoring packages for /home/myhome/test/test.csproj...
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error : Unable to load the service index for source https://api.nuget.org/v3/index.json. [/home/myhome/test/test.csproj]
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error :   The SSL connection could not be established, see inner exception. [/home/myhome/test/test.csproj]
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error :   The remote certificate is invalid according to the validation procedure. [/home/myhome/test/test.csproj]

若要解決此問題,請設定幾個環境變數:

export SSL_CERT_FILE=[path-to-certificate-file]
export SSL_CERT_DIR=/dev/null

憑證位置會因散發而有所不同。 以下是發現問題的發行版本位置:

Distribution Location
Fedora /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem
OpenSUSE \(英文\) /etc/ssl/ca-bundle.pem
Solus /etc/ssl/certs/ca-certificates.crt