安裝 NuGet 用戶端工具

  • 發行項

想要安裝套件？ 請參閱 安裝 NuGet 套件 的方式。

若要以套件取用者或建立者身分使用 NuGet，您可以使用命令列介面 (CLI) 工具以及 Visual Studio 中的 NuGet 功能。 本文簡要概述不同工具的功能、安裝它們的方式，以及它們相對的功能可用性。

若要開始使用 NuGet 來取用套件，請參閱：

若要開始建立 NuGet 套件，請參閱：

工具 描述 下載
dotnet.exe 適用於 .NET Core 與 .NET Standard 程式庫，以及以 .NET Framework 為目標之任何 SDK 樣式專案的 CLI 工具。 隨附於 .NET Core SDK，並提供所有平台上的核心 NuGet 功能。 (從 Visual Studio 2017 開始，dotnet CLI 會自動與任何 .NET Core 相關工作負載一起安裝。) .NET Core SDK
nuget.exe 適用於 .NET Framework 程式庫，以及以 .NET Standard 程式庫為目標之任何非 SDK 樣式專案的 CLI 工具。 在 Windows 上提供所有的 NuGet 功能，於 Mono 執行時在 Mac 和 Linux 上提供大部分功能。 nuget.exe
Visual Studio 在 Windows 上 ，NuGet 封裝管理員 隨附于 Visual Studio 2012 和更新版本。 Visual Studio 提供套件管理員 UI 和套件管理員主控台，您可以透過它們執行大部分 NuGet 作業。 Visual Studio
Visual Studio for Mac 在 Mac 上，某些 NuGet 功能是直接內建的。 封裝管理員主控台目前無法使用。 針對其他功能，請使用 dotnet.exe 或 nuget.exe CLI 工具。 Visual Studio for Mac
Visual Studio Code 在 Windows、Mac 或 Linux 上，NuGet 功能可透過市集擴充功能使用，或使用 dotnet.exe 或 nuget.exe CLI 工具。 Visual Studio Code

MSBuild CLI 也提供還原和建立套件的能力，這主要用於組建伺服器。 MSBuild 並非適合用來搭配 NuGet 使用的一般用途工具。

套件管理員主控台命令只能在 Windows 上的 Visual Studio 內運作，無法在其他 PowerShell 環境中運作。

Visual Studio

在 Visual Studio 2017 和更新版本上安裝

在 Visual Studio 2017 中啟動，此安裝程式包含 NuGet 套件管理員以及採用 .NET 的任何工作負載。 若要個別安裝，或若要確認已安裝封裝管理員，請執行 Visual Studio 安裝程式，並核取 [個別元件 > 程式碼工具 > NuGet 套件管理員 ] 底下 的選項。

在 Visual Studio 2015 和較舊版本上安裝

您可以從 下載 https://dist.nuget.org/index.html Visual Studio 2013 和 2015 的 NuGet 延伸模組。

針對 Visual Studio 2010 及更早版本，安裝「適用於 Visual Studio 的 NuGet 套件管理員」擴充功能。 請注意，如果您在搜尋結果的第一頁看不到延伸模組，請嘗試將 [排序依據] 下拉式清單變更為 [大部分下載] 或依字母順序排序。

CLI 工具

您可以使用 dotnet CLI 或 nuget.exe CLI 來支援 IDE 中的 NuGet 功能。 dotnet CLI 會隨一些 Visual Studio 工作負載一起安裝，例如 .NET Core。 nuget.exe CLI 必須單獨安裝，如先前所述。

這兩個 NuGet CLI 工具是 dotnet.exe 和 nuget.exe。 請參閱功能可用性以進行比較。

  • 若要以 .NET Core 或 .NET Standard 為目標，請使用 dotnet CLI。 SDK 樣式的專案格式需要 dotnet CLI，該格式使用 SDK 屬性。
  • 若以 .NET Framework 為目標 (限非 SDK 樣式專案)，請使用 nuget.exe CLI。 若專案是從 packages.config 移轉到 PackageReference，請使用 dotnet CLI。

dotnet.exe CLI

.NET Core 2.0 CLI dotnet.exe 適用於所有平台 (Windows、Mac 和 Linux)，並提供核心 NuGet 功能，例如安裝、還原和發行套件。 dotnet 提供與 .NET Core 專案檔 (例如 .csproj) 的直接整合，這在大多數案例中很有幫助。 dotnet 也會針對每個平台直接建置，而且不會要求您安裝 Mono。

安裝：

若要了解如何使用 dotnet CLI 的基本命令，請參閱使用 dotnet CLI 安裝和使用套件。

nuget.exe CLI

nuget.exe CLI (nuget.exe) 是適用於 Windows 的命令列公用程式，它提供所有 NuGet 功能，也可以在 Mac OSX 與 Linux 上使用 Mono 來執行，但有一些限制。

若要了解如何使用 nuget.exe CLI 的基本命令，請參閱使用 nuget.exe CLI 安裝和使用套件。

安裝：

Windows

注意

NuGet.exe 5.0 及更新版本需要.NET Framework 4.7.2 或更新版本才能執行。

  1. 請瀏覽 nuget.org/downloads 並選取 NuGet 3.3 或更高版本 (2.8.6 與 Mono 不相容)。 一律建議使用最新版本，需要 4.1.0 以上版本才能將套件發行至 nuget.org。
  2. 每個下載項目直接是 nuget.exe 檔案。 指示您的瀏覽器將檔案儲存到您選擇的資料夾。 該檔案不是安裝程式；如果直接從瀏覽器執行，您將不會看到任何項目。
  3. 將放置 nuget.exe 的資料夾新增至您的 PATH 環境變數中，以便從任何地方使用 CLI 工具。

macOS/Linux

行為可能會隨作業系統發佈而稍微不同。

  1. 安裝 Mono 4.4.2 或更新版本。

  2. 在殼層提示字元中執行下列命令：

    # Download the latest stable `nuget.exe` to `/usr/local/bin`
sudo curl -o /usr/local/bin/nuget.exe https://dist.nuget.org/win-x86-commandline/latest/nuget.exe

  3. 將下列指令碼加入到適用於您的作業系統的檔案 (通常為 ~/.bash_aliases 或 ~/.bash_profile) 來建立別名：

    # Create as alias for nuget
alias nuget="mono /usr/local/bin/nuget.exe"

  4. 重新載入殼層。 輸入 nuget (不含任何參數) 來測試安裝。 NuGet CLI 說明應該會顯示。

提示

在 Windows 上使用 nuget update -self，將現有的 nuget.exe 更新為最新版本。

注意

最新建議的 NuGet CLI 一律可在 https://dist.nuget.org/win-x86-commandline/latest/nuget.exe 找到。 為了與舊版持續整合系統相容，先前的 URL https://nuget.org/nuget.exe 目前會提供已被取代的 2.8.6 CLI 工具。

功能可用性

功能 dotnet CLI nuget CLI (Windows) nuget CLI (Mono) Visual Studio (Windows) Visual Studio for Mac
搜尋套件 ✔ ✔ ✔ ✔
安裝/解除安裝套件 ✔ ✔ （1） ✔ ✔ ✔
更新套件 ✔ ✔ ✔ ✔
還原套件 ✔ ✔ ✔ （2） ✔ ✔
管理套件摘要 (來源) ✔ ✔ ✔ ✔
管理摘要上的套件 ✔ ✔ ✔
設定摘要的 API 金鑰 ✔ ✔
建立套件(3) ✔ ✔ ✔ （4） ✔
發佈套件 ✔ ✔ ✔ ✔
複製套件 ✔ ✔
管理 global-package 和快取資料夾 ✔ ✔ ✔
管理 NuGet 組態 ✔ ✔

(1) 不會影響專案檔；請改為使用 dotnet.exe。

(2) 只能搭配 packages.config 檔案運作，無法搭配方案 (.sln) 檔案運作。

(3) 各種進階的套件功能只能透過 CLI 取得，因為這些功能不會在 Visual Studio UI 工具中呈現。

(4) 可搭配 .nuspec 檔案運作，但無法搭配專案檔運作。

即將推出的功能

如果您想要預覽即將推出的 NuGet 功能，請安裝 Visual Studio Preview ，其與穩定版本的 Visual Studio 並存運作。 若要針對預覽回報問題或分享想法，請在 NuGet GitHub 存放庫 \(英文\) 上建立問題。

在 Windows 上工作的開發人員也可以探索 NuGet 套件總管 \(英文\)，這是一個開放原始碼的獨立工具，可讓您以視覺化方式瀏覽、建立和編輯 NuGet 套件。 例如，它非常適合用來對套件結構進行實驗性變更，而不需重建套件。