安裝 NuGet 用戶端工具

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

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

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

• 安裝並使用套件 (dotnet CLI)
• 安裝和使用套件 （Windows 上的 Visual Studio）

若要開始建立 NuGet 套件，請參閱下列文章：

• 建立及發佈 NET Standard 套件 (dotnet CLI)
• 建立及發佈 NET Standard 套件 （Windows 上的 Visual Studio）

工具	描述	下載
dotnet SDK	.NET Core 和 .NET Standard 連結庫的 CLI 工具，以及任何 SDK 樣式專案 ，例如以 .NET Framework 為目標的專案。 此 CLI 工具隨附於 .NET Core SDK，並在所有平臺上提供核心 NuGet 功能。 在 Visual Studio 2017 和更新版本中，dotnet CLI 會自動隨任何 .NET Core 相關工作負載一起安裝。	.NET Core SDK
nuget.exe	.NET Framework 連結庫的 CLI 工具，以及任何 以 .NET Standard 連結庫為目標的非 SDK 樣式專案 。 此 CLI 工具會在 Windows 上提供所有 NuGet 功能，以及在 Mono 下執行時，Mac 和 Linux 上大部分的功能。	nuget.exe
Visual Studio	在 Windows 上，NuGet 封裝管理員 隨附於 Visual Studio 2012 和更新版本。 Visual Studio 提供 封裝管理員 UI 和 封裝管理員 控制台 （Windows 上的 PowerShell）。 您可以使用這些工具來執行大部分的 NuGet 作業。	Visual Studio
Visual Studio for Mac	在 Mac 上，某些 NuGet 功能會直接內建。 封裝管理員 主控台目前無法使用。 針對其他功能，請使用 dotnet SDK 或 nuget.exe CLI 工具。	Visual Studio for Mac
Visual Studio Code	在 Windows、Mac 和 Linux 上，NuGet 功能可透過市集延伸模組取得，或使用 dotnet SDK 或 nuget.exe CLI 工具。	Visual Studio Code

注意

Visual Studio for Mac 會根據 Microsoft的新式生命周期原則，於 2024 年 8 月 31 日前淘汰。 如需詳細資訊，請參閱 Visual Studio for Mac 發生什麼情況。

MSBuild CLI 也會還原並建立套件。 MSBuild 不是使用 NuGet 的一般用途工具。 此 CLI 工具主要適用於組建伺服器。

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

支援原則

您可以在 Visual Studio 產品生命週期和服務中找到 Visual Studio for Windows 支持原則。

最新版的NuGet.exe完全受到支援，而且可以依賴 Bug 修正、更新和增強功能。 如需NuGet.exe支持原則的詳細資訊，請參閱 Microsoft新式生命周期原則。

您可以在 .NET 和 .NET Core 支持原則中找到 .NET SDK 支持原則。

修補程式版本

在 Visual Studio 或 .NET SDK 的長期支援 （LTS） 版本需要重大安全性修正時，將專門發行已修補的 NuGet.exe版本。

所有安全性錯誤都應該回報給 MSRC 報告頁面Microsoft安全性回應中心 （MSRC）。 此外，請參閱 NuGet.Client 存放庫中的安全策略。

NuGet.exe取消列出

支援不足、已被取代或易受攻擊的NuGet.exe版本將會從 tools.json中移除。

Visual Studio

在 Visual Studio 2017 和更新版本中，Visual Studio 安裝程式包含 NuGet 封裝管理員，其中包含任何採用 .NET 的工作負載。

您也可以個別安裝 封裝管理員，或確認您的安裝。 執行 Visual Studio 安裝程式，並檢查 [個別元件>程式代碼工具 > NuGet 套件管理員] 底下的選項設定。 如需詳細資訊，請參閱使用 NuGet 封裝管理員 在 Visual Studio 中安裝和管理套件。

注意

針對舊版 Visual Studio，您可以在 下載 NuGet 延伸模組 https://dist.nuget.org/index.html。

CLI 工具

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

• 若要以 .NET Core 或 .NET Standard 為目標，請使用 dotnet SDK CLI 工具。 SDK 樣式專案格式需要此 CLI，其會使用 SDK 屬性。

• 若要以 .NET Framework 為目標（僅限非 SDK 樣式專案），請使用 nuget.exe CLI 工具。 如果專案從 packages.config 移轉至 PackageReference，請改用 dotnet SDK CLI 工具。

dotnet SDK

dotnet SDK 是 .NET Core 2.0 CLI 工具，可在所有平台上運作（Windows、Mac 和 Linux），並提供核心 NuGet 功能，例如安裝、還原和發佈套件。 dotnet CLI 提供與 .NET Core 項目檔的直接整合， .csproj這在大部分情況下都很有用。 此 CLI 也直接針對每個平臺建置，不需要安裝 Mono。

安裝 dotnet SDK

• 在開發人員電腦上，安裝 .NET Core SDK。 在 Visual Studio 2017 和更新版本中，dotnet CLI 會自動隨任何 .NET Core 相關工作負載一起安裝。

• 針對組建伺服器，請遵循指示，在 持續整合中使用 .NET Core SDK 和工具。

若要瞭解如何搭配 dotnet SDK CLI 工具使用基本命令，請參閱 使用 dotnet CLI 安裝和管理 NuGet 套件。

nuget.exe CLI

NuGet CLI nuget.exe是 Windows 的命令行公用程式，可提供所有 NuGet 功能。 此 CLI 也可以使用 Mono 在 Mac OSX 和 Linux 上執行，但有一些限制。

若要瞭解如何搭配 nuget.exe CLI 工具使用基本命令，請參閱 使用 nuget.exe CLI 管理 NuGet 套件。

安裝nuget.exe

Windows

請一律安裝 支援您設定的最新版本 工具。

• 您可以在 下載最新的建議版本 https://dist.nuget.org/win-x86-commandline/latest/nuget.exe。
• 如果您已安裝 nuget.exe CLI 工具，您可以使用 命令 nuget update -self將工具更新為最新版本。
• 為了與較舊的持續整合系統相容，先前的 URL https://nuget.org/nuget.exe 目前提供 CLI 工具已被取代的版本 2.8.6 。

1. 請 流覽 nuget.org/downloads 並下載 NuGet 3.3 版或更新版本。

   • 5.0 版和更新版本需要 .NET Framework 4.7.2 版或更新版本。
   • 需要 4.1.0 版和更新版本，才能將套件發佈至 nuget.org。
   • 2.8.6 版與Mono不相容。

2. 每個下載項目直接是 nuget.exe 檔案。 指示您的瀏覽器將檔案儲存到您選擇的資料夾。 下載檔不是安裝程式，因此，如果您直接從瀏覽器執行檔案，則不會看到任何專案。

3. 若要從任何地方使用 CLI 工具，請將檔案的資料夾位置 nuget.exe 新增至您的PATH環境變數。

macOS / Linux

行為會根據您的操作系統散發方式稍有不同。

注意

Visual Studio for Mac 會根據 Microsoft的新式生命周期原則，於 2024 年 8 月 31 日前淘汰。 如需詳細資訊，請參閱 Visual Studio for Mac 發生什麼情況。

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 說明應該會顯示。

功能可用性

下表比較支持平臺的 dotnet 和 nuget.exe 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 SDK CLI 工具。
• (2) 只能搭配 packages.config 檔案運作，無法搭配方案 (.sln) 檔案運作。
• (3) 各種進階的套件功能只能透過 CLI 取得，因為這些功能不會在 Visual Studio UI 工具中呈現。
• (4) 可搭配 .nuspec 檔案運作，但無法搭配專案檔運作。

即將推出的功能

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

相關文章

• 使用 Visual Studio 安裝及管理套件
• 使用 dotnet CLI 安裝及管理套件
• 使用 nuget.exe CLI 安裝和管理套件
• 使用 PowerShell 安裝和管理套件
• 使用 nuget.exe CLI 建立套件
• 發佈 NuGet 套件
• 套件管理員主控台 PowerShell 參考

在 Windows 上工作的開發人員也可以探索 NuGet 套件總管。 此應用程式是開放原始碼的獨立工具，可讓您以可視化方式探索、建立和編輯 NuGet 套件。 這對許多案例很有説明，例如對套件結構進行實驗性變更，而不需重建套件。