共用方式為


安裝 NuGet 用戶端工具

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

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

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

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

工具 描述 下載
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

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

  • 您可以在 下載最新的建議版本 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環境變數。

功能可用性

下表比較支持平臺的 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 存放庫 \(英文\) 上建立問題。

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