分享方式:


NuGet CLI 參考

NuGet 命令行介面 (CLI) nuget.exe提供 NuGet 功能的完整範圍,以安裝、建立、發佈及管理套件,而不需對專案檔進行任何變更。

若要使用任何命令,請開啟命令視窗或bash殼層,然後執行 nuget ,後面接著命令和適當的選項,例如 nuget help pack (若要檢視套件命令的說明)。

本檔反映最新版的 NuGet CLI。 如需您所使用之任何指定版本的詳細數據,請針對所需的命令執行 nuget help

若要了解如何使用 nuget.exe CLI 的基本命令,請參閱使用 nuget.exe CLI 安裝和使用套件

安裝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環境變數。

提示

若要在 Visual Studio 的 封裝管理員 控制台內提供 NuGet CLI,請參閱在控制台中使用 nuget.exe CLI。

可用性

如需確切的詳細數據,請參閱 功能可用性

  • 所有命令都可在 Windows 上使用。
  • 所有命令都會在Mono上執行nuget.exe,但、 和 update所指示packrestore的位置除外。
  • packrestoredeletelocalspush 命令也可透過 dotnet CLI 在 Mac 和 Linux 上使用。

命令和適用性

封裝建立、套件耗用量和/或將套件發行至主機的可用命令和適用性:

常見命令 適用的角色 NuGet 版本 描述
pack 建立 2.7+ .nuspec 或項目檔建立 NuGet 套件。 在Mono上執行時,不支援從項目檔建立套件。
push 發佈 全部 將套件發佈至套件來源。
config 全部 全部 取得或設定 NuGet 組態值。
help or ? 全部 全部 顯示命令的說明資訊或說明。
locals 耗用 3.3+ 列出 global-packagesHTTP-cachetemp 資料夾的位置,並清除這些資料夾的內容。
還原 耗用 2.7+ 還原使用中套件管理格式所參考的所有套件。 在 Mono 上執行時,不支援使用 PackageReference 格式還原套件。
setapikey 發佈、取用 全部 當該套件來源需要金鑰進行存取時,儲存指定套件來源的 API 金鑰。
spec 建立 全部 .nuspec從 Visual Studio 專案產生檔案時,使用令牌產生檔案。
次要命令 適用的角色 NuGet 版本 描述
add 發佈 3.3+ 使用階層式配置,將套件新增至非 HTTP 套件來源。 針對 HTTP 來源,請使用 推送
delete 發佈 全部 從套件來源移除或取消列出套件。
init 建立 3.3+ 使用階層式配置,將封裝從資料夾新增至套件來源。
install 耗用 全部 將套件安裝到目前的專案中,但不會修改專案或參考檔案。
清單 耗用量,也許發佈 全部 顯示來自指定來源的套件。
mirror 發佈 在 3.2+ 中已被取代 將套件及其相依性從來源鏡像到目標存放庫。
search 耗用 5.8+ 使用提供的查詢字串來搜尋指定的來源。
sources 取用、發佈 全部 管理組態檔中的套件來源。
update 耗用 全部 更新 專案套件至最新的可用版本。 在 Mono 上執行時不支援。

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

適用角色的 NuGet CLI 命令:

角色 命令
耗用 confighelpinstalllistlocalsrestoresearch、、setapikey、、 sourcesupdate
建立 config、、 helpinitpackspec
發佈 addconfigdeletehelplistpush、、、 setapikeysources

例如,只涉及取用套件的開發人員只需要瞭解 NuGet 命令的子集。

注意

命令選項名稱不區分大小寫。 已被取代的選項不包含在此參考中,例如 NoPrompt (取代為 NonInteractive) 和 Verbose (取代為 Verbosity)。

當地語系化

NuGet.exe進度、警告和錯誤訊息會轉譯為與Visual Studio相同的地區設定。 NuGet.exe隨附為單一 exe,而且由於大小考慮,所有語言中只會翻譯最常見的訊息。