使用 NuGet CLI 管理 NuGet 套件

  • 發行項

您可以使用 nuget.exe CLI 工具來管理 Visual Studio 專案和解決方案中的 NuGet 套件。 本文說明管理 NuGet 套件的最常見 NuGet CLI 命令。 所有這些命令都可以在 Windows 上運作，而且大部分在 Mac 和 Linux 上使用 Mono。

NuGet CLI 會在 .NET Framework 和非 SDK 樣式專案上執行，例如以 .NET Standard 連結庫為目標的非 SDK 樣式專案。 NuGet CLI 命令可以使用列出套件參考的專案 packages.config 檔案。 對於使用 PackageReference 而非 packages.config 進行套件參考的非 SDK 樣式專案，請改用 dotnet CLI 。

注意

對於大部分使用 packages.config 的非 SDK 樣式專案，最好將 packages.config 移轉至 PackageReference，然後使用 dotnet CLI 而不是 NuGet CLI 來管理套件。 不過，您無法移轉 C++ 或 ASP.NET 專案。

針對大部分的命令，NuGet CLI 工具會使用目前的目錄，除非您在命令中指定不同的位置。 若要執行 NuGet CLI 命令，請開啟命令行，並切換至包含專案檔的目錄。

如需命令及其自變數的完整清單，請參閱 NuGet CLI 參考。

必要條件

從 nuget.org 下載 NuGet CLI。將 nuget.exe 檔案儲存至適當的目錄，並確定目錄位於您的PATH環境變數中。

注意

您也可以使用適用於 Windows 的 winget 工具或 macOS 的 Homebrew 。

若要找出您的 NuGet CLI 版本，請開啟命令列並執行 nuget help，或避免必須向上捲動，請使用 nuget help | more。 說明輸出中的第一行會顯示版本。

安裝套件

NuGet CLI 安裝 命令會下載並安裝指定的 NuGet 套件。

重要

命令 install 不會修改項目檔或 packages.config 檔案。 install和 restore 命令只會將套件新增至磁碟，但不會將相依性新增至專案。 若要新增專案相依性，請透過Visual Studio 封裝管理員 UI 或 封裝管理員 Console 新增套件，然後執行 install 或 restore。

-OutputDirectory使用 選項將套件安裝到特定目錄。 如果您未指定輸出目錄， install 請使用目前的目錄。

nuget install <packageID | configFilePath> -OutputDirectory <outputDirectory>

例如，若要將 Newtonsoft.json 套件安裝至 packages 子目錄，請使用下列命令：

nuget install Newtonsoft.Json -OutputDirectory packages

您可以指定目前或另一個目錄中的現有 packages.config 檔案，而不是指定要安裝的套件。 命令install會安裝 packages.config 檔案中列出的所有套件。

nuget install packages.config

例如，下列命令會將 config 子目錄中 packages.config中列出的所有套件安裝到 packages 子目錄：

nuget install config\packages.config -OutputDirectory packages

安裝特定版本的套件

除非您指定不同的版本，否則 install 命令會安裝最新版本的套件。 若要安裝特定版本的套件，請使用 -Version 選項：

nuget install <packageID | configFilePath> -Version <version>

例如，若要安裝套件 12.0.1 Newtonsoft.json 版，請使用：

nuget install Newtonsoft.Json -Version 12.0.1

列出套件

使用 list 命令來顯示套件資料夾中安裝的套件清單。 -Source使用 選項來限制清單。

nuget list -Source <source>

例如，若要列出 MyProject 套件子目錄中的套件，請使用：

nuget list -Source C:\Users\%USERNAME%\source\repos\MyProject\packages

您也可以使用搜尋字詞來搜尋套件名稱、標籤或描述：

nuget list <"search term"> -Source <source>

更新所有套件

使用 update 命令，將專案 packages.config 檔案中的所有套件更新為其最新的可用版本。 最好先執行 restore ，再執行 update。

nuget update

移除套件

若要移除封裝，請從專案資料夾刪除該套件。 若要重新安裝套件，請使用 restore 或 install 命令。

從磁碟刪除套件並不會更新專案、 packages.config 或 NuGet.Config 檔案。 拿掉套件的最佳方式是透過Visual Studio 封裝管理員UI或 封裝管理員 Console。

還原套件

NuGet CLI 還原 命令會下載並安裝任何遺失的套件。 此命令適用於使用 PackageReference 或 packages.config 進行套件參考的專案。

如同install，restore命令只會將套件新增至磁碟，但不會修改專案檔或 packages.config。若要新增專案相依性，請使用Visual Studio 封裝管理員 UI 或控制台。

若要還原套件，請執行下列命令：

nuget restore <projectPath>

命令 restore 會在指定的項目路徑中使用方案檔或 package.config 檔案。

例如，若要還原目前目錄中MySolution.sln的所有套件，請執行：

nuget restore MySolution.sln

注意

對於使用 PackageReference的非 SDK 樣式專案，請改用 msbuild -t：restore 還原套件。

如需詳細資訊，請參閱 還原套件。

下一步