安裝 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 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 套件。 這對許多案例很有説明，例如對套件結構進行實驗性變更，而不需重建套件。