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的位置除外。
  • pack、restore、delete、 locals和 push 命令也可透過 dotnet CLI 在 Mac 和 Linux 上使用。

命令和適用性

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

常見命令 適用的角色 NuGet 版本 描述
pack 建立 2.7+ 從 .nuspec 或項目檔建立 NuGet 套件。 在Mono上執行時，不支援從項目檔建立套件。
push 發佈 全部 將套件發佈至套件來源。
config 全部 全部 取得或設定 NuGet 組態值。
help or ? 全部 全部 顯示命令的說明資訊或說明。
locals 耗用 3.3+ 列出 global-packages、HTTP-cache 和 temp 資料夾的位置，並清除這些資料夾的內容。
還原 耗用 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 命令：

角色 命令
耗用 config、help、install、list、locals、restore、search、、setapikey、、 sourcesupdate
建立 config、、 help、 init、 pack、 spec
發佈 add、config、delete、help、list、push、、、 setapikeysources

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

注意

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

當地語系化

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