使用 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 還原套件。
如需詳細資訊,請參閱 還原套件。