安裝 NuGet 用戶端工具

想安裝套件嗎？ 請參閱 安裝 NuGet 套件的方法。

若要使用 NuGet 作為套件消費者或創建者，您可以使用命令列介面（CLI）工具及 Visual Studio 中的 NuGet 功能。 本文簡要介紹各種工具的功能。 同時也說明如何安裝這些工具，並 比較各工具間的功能可用性。

NuGet 快速入門

要開始使用 NuGet 來使用套件，請參考以下文章：

要開始製作 NuGet 套件，請參考以下文章：

工具概觀

Tool 說明 下載
dotnet SDK 這是用於 .NET 和 .NET 標準函式庫的 CLI 工具，以及任何 SDK 風格專案，例如針對 .NET Framework 的專案。 此 CLI 工具包含在 .NET SDK 中，並在所有平台上提供核心 NuGet 功能。 在 Visual Studio 2017 及以後版本中，dotnet CLI 會自動安裝在任何與 .NET 相關的工作負載中。 .NET SDK
nuget.exe 此 CLI 工具適用於 .NET Framework 函式庫，以及任何 非 SDK 風格的專案，例如針對 .NET Standard 函式庫的專案。 此 CLI 工具在 Windows 上提供所有 NuGet 功能，並在 macOS 和 Linux 上運行於 Mono 上提供大部分功能。 nuget.exe
Visual Studio 一個完整的整合開發環境（IDE），包含 NuGet Package Manager。 Visual Studio 提供 Package Manager UI 以及 Package Manager 主控台（PowerShell on Windows）。 你可以用這些工具來執行大多數 NuGet 操作。 Visual Studio
Visual Studio 程式碼 一款輕量級、開源的程式碼編輯器，支援 Windows、macOS 和 Linux，透過市集擴充功能提供 NuGet 功能。 你也可以在 Visual Studio Code 裡使用 dotnet SDK 或 nuget.exe CLI 工具。 Visual Studio 程式碼

你也可以使用 Microsoft Build 引擎（MSBuild）CLI 來還原和建立套件。 但 MSBuild 並不是一個通用的工具來使用 NuGet。 此 CLI 工具主要用於建置伺服器。

Package Manager 控制台指令僅能在 Windows 的 Visual Studio 中運作，且無法在其他 PowerShell 環境中使用。

支援原則

請參閱 Visual Studio 產品生命週期與服務，以了解有關 Windows 版 Visual Studio 的支援政策。

nuget.exe最新版本已完全支援，且可信賴於錯誤修正、更新與增強。 欲了解更多支援政策資訊 nuget.exe ，請參閱 現代生命週期政策。

關於 .NET SDK 支援政策，請參見 .NET 及 .NET 核心支援政策。

補丁版本

已修補的 nuget.exe 版本僅在需要對長期支援（LTS）版本的 Visual Studio 或 .NET SDK 進行關鍵安全修補時才發布。

所有安全漏洞應於 MSRC 報告頁面 向Microsoft Security Response Center（MSRC）報告。 有關報告安全問題的詳細資訊，請參閱 NuGet.Client 倉庫中的安全政策。

NuGet.exe 下架

已不支援、棄用或有 nuget.exe 漏洞的版本會從 tools.json 端點移除。

Visual Studio

在 Visual Studio 2017 及之後的版本中，Visual Studio 安裝程式會隨附可使用 .NET 的任何工作負載的 NuGet Package Manager。

你也可以另外安裝 Package Manager，或驗證安裝狀況。 執行Visual Studio安裝程式，並檢查Individual components>Code tools>NuGet 套件管理器 下的選項設定。 欲了解更多資訊，請參閱 在 Visual Studio 中使用 NuGet Package Manager 安裝與管理套件。

CLI 工具

你可以使用 dotnet CLI 或 nuget.exe CLI 來支援 Visual Studio IDE 中的 NuGet 功能。 dotnet CLI 是隨部分 Visual Studio 工作負載安裝的，例如 .NET。 nuget.exe CLI 必須如前所述獨立安裝。 關於工具的功能比較，請參閱 功能可用性 章節。

  • 若要鎖定 .NET 或 .NET 標準，請使用 dotnet SDK CLI 工具。 此 CLI 是 SDK 風格專案格式所必需，該格式使用 屬性SDK。

  • 若要針對 .NET Framework（僅限非 SDK 風格專案），請使用 nuget.exe CLI 工具。 如果專案從格式遷移 packages.config 到 PackageReference，請改用 dotnet SDK 的 CLI 工具。

dotnet SDK

dotnet SDK 是 .NET CLI 工具。 它支援所有平台（Windows、macOS 和 Linux），並提供核心 NuGet 功能，如安裝、還原及發佈套件。 dotnet CLI 可直接整合.NET專案檔案，例如 .csproj，這在大多數情境下都很有幫助。 此 CLI 也是為每個平台直接建置，且不需安裝 Mono。

安裝 dotnet SDK

  • 在開發者電腦上，安裝 .NET SDK。 在 Visual Studio 2017 及以後版本中，dotnet CLI 會自動安裝在任何與 .NET 相關的工作負載中。

  • 對於建置伺服器，請依照指示在持續整合（CI）環境中使用 .NET SDK 。

想了解如何使用 dotnet SDK CLI 工具使用基本指令，請參考「 使用 dotnet CLI 安裝與管理 NuGet 套件」。

nuget.exe 命令行介面 (CLI)

NuGet CLI，nuget.exe，是Windows的命令列工具，提供所有 NuGet 功能。 此 CLI 也能在 macOS 和 Linux 上運行，但使用 Mono 有限制。

想了解如何使用 nuget.exe CLI 工具使用基本指令，請參閱 「用 nuget.exe CLI 管理 NuGet 套件」。

安裝 nuget.exe

務必安裝支援你設定的 最新版本 工具。

如果 nuget.exe CLI 工具已經安裝，你可以用指令 nuget update -self. 將工具更新到最新版本。

  1. 下載 nuget.exe：

  2. 當被提示時，將檔案儲存到你選擇的資料夾。 nuget.exe 檔案是直接下載的。 下載的檔案不是安裝程式，所以不需要直接從瀏覽器執行。

  3. 要從任何資料夾使用 CLI 工具，請將包含 nuget.exe 檔案的資料夾加入你的 PATH 環境變數。

功能可用性

下表比較了 dotnet CLI、nuget.exe CLI 及支援平台Visual Studio工具的可用功能。

Feature dotnet 命令列介面 nuget CLI （Windows） nuget CLI（Mono） Visual Studio
搜尋套件 ✔ ✔ ✔ ✔
安裝或卸載套件 ✔ ✔ （1） ✔ ✔
更新套件 ✔ ✔ ✔
恢復套件 ✔ ✔ ✔ （2） ✔
管理套件訂閱（來源） ✔ ✔ ✔ ✔
管理訂閱串流中的包裹 ✔ ✔ ✔
設定 API 金鑰用於訂閱 ✔ ✔
建立套件（3） ✔ ✔ ✔ （4） ✔
發佈套件 ✔ ✔ ✔ ✔
複製套件 ✔ ✔
管理 全域套件 與快取資料夾 ✔ ✔ ✔
管理 NuGet 配置 ✔ ✔ ✔

特色說明：

  • （1） 使用此功能不會影響專案檔案。 改用 dotnet SDK 的 CLI 工具吧。
  • （2） 此功能僅適用於 packages.config 檔案，無法支援解決方案（.sln 或 .slnx）檔案。
  • （3） 各種進階套件功能僅能透過 CLI 使用，因為這些功能未在 Visual Studio UI 工具中呈現。
  • （4） 此功能適用於 .nuspec 檔案，但無法支援專案檔案。

即將推出的功能

如果你想預覽即將推出的 NuGet 功能，請安裝 Insiders Channel 版本的 Visual Studio，該版本可與穩定版的 Visual Studio 並行使用。 若要回報問題或分享預覽點子，請在 NuGet GitHub 倉庫 開啟一個議題。

相關內容

開發 Windows 的開發者也可以探索 NuGet 套件探索器。 這個應用程式是一個開源的獨立工具，你可以用來視覺化地探索、建立和編輯 NuGet 套件。 它在許多情境下都很有幫助，例如在不重建套件的情況下，對套件結構做實驗性變更。

  • Last updated on