NuGet CLI 參考

NuGet 命令列介面(CLI) nuget.exe提供 NuGet 的完整功能,讓您安裝、建立、發佈及管理套件,無需更改專案檔案。

要使用任何指令,先開啟指令視窗或 bash shell,然後執行 nuget ,接著是指令和相應的選項,例如 nuget help pack (查看 pack 指令的說明)。

本文件反映最新版本的 NuGet CLI。 如果你想了解你用的每個版本的詳細資訊,可以執行 nuget help 你想要的指令。

想學習如何使用基本指令搭配 nuget.exe CLI,請參閱 使用 nuget.exe CLI 安裝與使用套件

安裝 nuget.exe

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

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

  1. 下載 nuget.exe

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

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

小提示

要讓 NuGet CLI 在 Visual Studio 的 Package Manager 控制台中可用,請參見 在控制台中使用 nuget.exe CLI。

可用性

詳情請參閱 功能可用性

  • 所有指令皆可在 Windows 上使用。
  • 除了 pack、 、 restoreupdate之外,所有指令都能在 Mono 上執行 nuget.exe 上運作。
  • pack這些 、 restoredeletelocals、 和 push 指令也可透過 dotnet CLI 在 Mac 和 Linux 上使用。

指令與適用範圍

可用於套件建立、套件使用及/或發佈套件給主機的指令與適用性:

常用指令 適用角色 NuGet 版本 說明
創造 2.7+ .nuspec 一個 or 專案檔案建立 NuGet 套件。 在 Mono 上執行時,不支援從專案檔案建立套件。
push 出版 全部 將套件發佈到套件來源。
組態 全部 全部 取得或設定 NuGet 設定值。
求助還是? 全部 全部 顯示幫助資訊或指令說明。
地方 使用量 3.3+ 列出 global-packageshttp-cachetemp 資料夾的位置,並清除這些資料夾的內容。
還原 使用量 2.7+ 還原所有以套件管理格式所參考的套件。 在 Mono 上執行時,不支援使用 PackageReference 格式還原套件。
Setapikey 出版與消費 全部 當該套件來源需要存取金鑰時,會為該套件來源儲存 API 金鑰。
規格 創造 全部 產生一個 .nuspec 檔案,若從 Visual Studio 專案產生檔案,則使用標記。
次要指揮部 適用角色 NuGet 版本 說明
add 出版 3.3+ 使用階層式佈局,將套件加入非 HTTP 套件來源。 對於 HTTP 來源,請使用 push
delete 出版 全部 從套件來源移除或取消列出套件。
init 創造 3.3+ 使用階層式配置,將資料夾中的套件加入套件來源。
安裝 使用量 全部 將套件安裝到目前專案中,但不會修改專案或參考檔案。
清單 消費,或許是出版 全部 顯示來自特定來源的套件。
鏡子 出版 在 3.2+ 版本中被淘汰 將套件及其相依關係從來源鏡像到目標儲存庫。
搜尋 使用量 5.8+ 利用提供的查詢字串搜尋特定來源。
資料來源 消費與出版 全部 管理設定檔中的套件來源。
更新 使用量 全部 將專案的套件更新為最新可用版本。 在單線模式下不支援。

不同指令會使用各種 環境變數

依適用角色分類的 NuGet CLI 指令:

角色 Commands
使用量 confighelpinstalllistlocalsrestoresearchsetapikeysourcesupdate
創造 config、、 helpinitpackspec
出版 addconfigdeletehelplistpushsetapikeysources

例如,只關心消耗套件的開發者,只需理解那部分 NuGet 指令即可。

備註

指令選項名稱不區分大小寫。 已棄用的選項未包含在本參考中,例如 NoPrompt (被 替換為 NonInteractive)和 Verbose (被替換為 Verbosity)。

本地化

NuGet.exe的進度、警告和錯誤訊息會被翻譯成與Visual Studio相同的區域。 NuGet.exe 以單一執行檔形式發佈,且因尺寸考量,只有最常出現的訊息會被翻譯成所有語言。