NuGet CLI 參考

(CLI) 的 NuGet 命令列介面 nuget.exe 可提供 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 或更新版本才能執行。

  1. 請瀏覽 nuget.org/downloads 並選取 NuGet 3.3 或更高版本 (2.8.6 與 Mono 不相容)。 一律建議使用最新版本,需要 4.1.0 以上版本才能將套件發行至 nuget.org。
  2. 每個下載項目直接是 nuget.exe 檔案。 指示您的瀏覽器將檔案儲存到您選擇的資料夾。 該檔案不是安裝程式;如果直接從瀏覽器執行,您將不會看到任何項目。
  3. 將放置 nuget.exe 的資料夾新增至您的 PATH 環境變數中,以便從任何地方使用 CLI 工具。

macOS/Linux

行為可能會隨作業系統發佈而稍微不同。

  1. 安裝 Mono 4.4.2 或更新版本

  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
    
  3. 將下列指令碼加入到適用於您的作業系統的檔案 (通常為 ~/.bash_aliases~/.bash_profile) 來建立別名:

    # Create as alias for nuget
    alias nuget="mono /usr/local/bin/nuget.exe"
    
  4. 重新載入殼層。 輸入 nuget (不含任何參數) 來測試安裝。 NuGet CLI 說明應該會顯示。

提示

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

可用性

如需確切詳細資料,請參閱 功能可用性

  • 所有命令都可在 Windows 上使用。
  • 所有命令都適用于 Mono 上執行的 nuget.exe,除了針對、和所指定的位置 pack restore update
  • pack restore delete locals push 也可以透過 dotnet CLI,在 Mac 和 Linux 上使用、、、和命令。

命令和適用性

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

常見命令 適用角色 NuGet 版本 描述
pack 建立 2.7+ 從或專案檔建立 NuGet 套件 .nuspec 。 在 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) 取代。