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 。
請 流覽 nuget.org/downloads 並下載 NuGet 3.3 版或更新版本。
- 5.0 版和更新版本需要 .NET Framework 4.7.2 版或更新版本。
- 需要 4.1.0 版和更新版本,才能將套件發佈至
nuget.org
。 - 2.8.6 版與Mono不相容。
每個下載項目直接是
nuget.exe
檔案。 指示您的瀏覽器將檔案儲存到您選擇的資料夾。 下載檔不是安裝程式,因此,如果您直接從瀏覽器執行檔案,則不會看到任何專案。若要從任何地方使用 CLI 工具,請將檔案的資料夾位置
nuget.exe
新增至您的PATH環境變數。
提示
若要在 Visual Studio 的 封裝管理員 控制台內提供 NuGet CLI,請參閱在控制台中使用 nuget.exe CLI。
可用性
如需確切的詳細數據,請參閱 功能可用性 。
- 所有命令都可在 Windows 上使用。
- 所有命令都會在Mono上執行nuget.exe,但、 和
update
所指示pack
restore
的位置除外。 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 、、 sources update |
建立 | config 、、 help 、 init 、 pack 、 spec |
發佈 | add 、config 、delete 、help 、list 、push 、、、 setapikey sources |
例如,只涉及取用套件的開發人員只需要瞭解 NuGet 命令的子集。
注意
命令選項名稱不區分大小寫。 已被取代的選項不包含在此參考中,例如 NoPrompt
(取代為 NonInteractive
) 和 Verbose
(取代為 Verbosity
)。
當地語系化
NuGet.exe進度、警告和錯誤訊息會轉譯為與Visual Studio相同的地區設定。 NuGet.exe隨附為單一 exe,而且由於大小考慮,所有語言中只會翻譯最常見的訊息。