NuGet CLI 參考
(CLI) nuget.exe 的 NuGet 命令列介面可提供完整的 NuGet 功能，以安裝、建立、發行和管理套件，而不需要對專案檔進行任何變更。
若要使用任何命令，請開啟命令視窗或 bash shell，然後執行 nuget 命令和適當的選項，例如 nuget help pack (來查看 pack 命令) 的說明。
本檔會反映 NuGet CLI 的最新版本。 如需您所使用之任何指定版本的確切詳細資料，請執行 nuget help 所需的命令。
若要了解如何使用 nuget.exe CLI 的基本命令，請參閱使用 nuget.exe CLI 安裝和使用套件。
安裝 nuget.exe
Windows
注意
NuGet.exe 5.0 及更新版本需要.NET Framework 4.7.2 或更新版本才能執行。
- 請瀏覽 nuget.org/downloads 並選取 NuGet 3.3 或更高版本 (2.8.6 與 Mono 不相容)。 一律建議使用最新版本，需要 4.1.0 以上版本才能將套件發行至 nuget.org。
- 每個下載項目直接是
nuget.exe檔案。 指示您的瀏覽器將檔案儲存到您選擇的資料夾。 該檔案不是安裝程式；如果直接從瀏覽器執行，您將不會看到任何項目。 - 將放置
nuget.exe的資料夾新增至您的 PATH 環境變數中，以便從任何地方使用 CLI 工具。
macOS/Linux
行為可能會隨作業系統發佈而稍微不同。
安裝 Mono 4.4.2 或更新版本。
在殼層提示字元中執行下列命令：
# Download the latest stable `nuget.exe` to `/usr/local/bin` sudo curl -o /usr/local/bin/nuget.exe https://dist.nuget.org/win-x86-commandline/latest/nuget.exe將下列指令碼加入到適用於您的作業系統的檔案 (通常為
~/.bash_aliases或~/.bash_profile) 來建立別名：# Create as alias for nuget alias nuget="mono /usr/local/bin/nuget.exe"重新載入殼層。 輸入
nuget(不含任何參數) 來測試安裝。 NuGet CLI 說明應該會顯示。
提示
若要在 Visual Studio 的封裝管理員主控台內提供 NuGet CLI，請參閱在主控台中使用 nuget.exe CLI。
可用性
如需確切詳細資料，請參閱 功能可用性 。
- 所有命令都可在 Windows 上取得。
- 所有命令都適用于 Mono 上執行的 nuget.exe，除了針對
pack、restore和update所指定的位置。 pack您也可以透過 dotnet CLI，在 Mac 和 Linux 上使用、restoredelete、、locals和push命令。
命令和適用性
可用的命令和適用于封裝建立、套件耗用量，以及/或將套件發行至主機的適用性：
| 常見命令 | 適用角色 | NuGet 版本 | 描述 |
|---|---|---|---|
| pack | 建立 | 2.7+ | 從 .nuspec 或專案檔建立 NuGet 套件。 在 Mono 上執行時，不支援從專案檔建立套件。 |
| push | 發佈 | 全部 | 將封裝發佈至套件來源。 |
| config | 全部 | 全部 | 取得或設定 NuGet 設定值。 |
| help or ? | 全部 | 全部 | 顯示命令的說明資訊或說明。 |
| locals | 取用量 | 3.3 + | 列出 全域套件、 HTTP快取和 暫存 資料夾的位置，並清除這些資料夾的內容。 |
| restore | 取用量 | 2.7+ | 還原使用中封裝管理格式所參考的所有套件。 在 Mono 上執行時，不支援使用 PackageReference 格式來還原封裝。 |
| setapikey | 發佈、耗用量 | 全部 | 當套件來源需要存取金鑰時，為指定的套件來源儲存 API 金鑰。 |
| spec | 建立 | 全部 | .nuspec如果從 Visual Studio 專案產生檔案，則會使用標記產生檔案。 |
| 次要命令 | 適用角色 | NuGet 版本 | 描述 |
|---|---|---|---|
| add | 發佈 | 3.3 + | 使用階層式配置將封裝新增至非 HTTP 套件來源。 若為 HTTP 來源，請使用 push。 |
| delete | 發佈 | 全部 | 從套件來源移除或取消列出封裝。 |
| init | 建立 | 3.3 + | 使用階層式配置將封裝從資料夾新增至套件來源。 |
| install | 取用量 | 全部 | 將封裝安裝至目前的專案，但不會修改專案或參考檔案。 |
| list | 耗用量，或許是發佈 | 全部 | 顯示指定來源的封裝。 |
| 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) 取代。