Microsoft Visual Studio for Windows 中的 NuGet 套件管理員 UI 可讓您輕鬆地在專案和方案中安裝、卸載及更新 NuGet 套件。
本文僅適用於 Windows 使用者。 如果您使用 Visual Studio for Mac,請參閱 如何在專案中加入 NuGet 套件。
先決條件
安裝適用於 Windows 並與任何 .NET 相關工作負載的 Visual Studio 2022。
您可以從 visualstudio.microsoft.com免費安裝 2022 Community 版本,或使用 Professional 或 Enterprise 版本。
Visual Studio 2017 和更新版本在安裝 .NET 相關工作負載時會自動包含 NuGet 套件管理員。 若要在 Visual Studio 安裝程式中個別安裝,請選取 [個別元件] 索引卷標,然後在 [程式代碼工具] 底下選取 [NuGet 套件 管理員]。
針對 Visual Studio 2015,如果您遺失 NuGet 套件管理員,請檢查 Tools>Extensions and Updates,然後搜尋 NuGet 套件管理員 延伸模組。 如果您無法在 Visual Studio 中使用擴充功能安裝程式,請直接從 https://dist.nuget.org/index.html下載延伸模組。
如果您還沒有免費帳戶,請在 nuget.org注册免费帐户。 您必須先註冊並確認帳戶,才能上傳 NuGet 套件。
尋找並安裝套件
若要使用 Visual Studio 尋找並安裝 NuGet 套件,請遵循下列步驟:
在 [方案總管]中載入專案,然後選取 [專案]>[管理 NuGet 套件]。
NuGet 套件管理員 視窗隨即開啟。
從目前選取的來源選取 [瀏覽] 標籤,以依受歡迎程度顯示套件(請參閱 套件來源)。
- 若要搜尋特定套件,請使用左上方的搜尋方塊。
- 每個套件標識子旁邊可能會顯示縮寫資訊,以協助識別正確的套件,並根據選取的套件來源而有所不同。 範例包括套件下載計數、作者或擁有者配置檔超連結。
注意
在 Visual Studio 17.11 和更高版本中,當選定的套件來源支援時,套件擁有者會顯示為個人資料超連結。 套件擁有權是由套件來源所定義。 例如,請參閱 在 nuget.org 上管理套件擁有者。
在 Visual Studio 17.10 和更早版本中,會顯示套件 作者 元數據,顯示為純文本。 如需詳細資訊,請參閱 作者套件元資料。
- 選取套件以查看詳細的套件資訊。
右側的詳細數據窗格隨即出現,並可讓您選取要安裝的版本。
您可以在 [套件詳細資訊] 索引標籤中看到套件元數據、擁有者、作者、授權等相關信息,以及在 [README] 索引標籤中查看套件自述檔(如果套件作者有提供)。
在右窗格中,從下拉式清單中選取 版本。 如果您要在 [版本] 清單中包含發行前版本,請選取 [包含發行前版本] 。
若要安裝 NuGet 套件,請選取 [安裝]。 系統可能會要求您接受授權條款,或提示您確認安裝。
Visual Studio 會在專案中安裝套件及其相依性。 安裝完成時,新增的套件會出現在 [已安裝的 ] 索引標籤上。您也可以在 [方案總管] [方案總管] 中,於專案的 [相依性>套件] 節點中找到套件。 安裝套件之後,您可以使用
using
語句在項目中參考它。(選擇性)NuGet 有兩種格式,專案可以使用套件:PackageReference 和 packages.config。若要設定預設格式,請選取 [工具]>[選項],展開 [NuGet 套件管理員],選取 [一般],然後選擇 [預設套件管理格式]。 如需詳細資訊,請參閱 選擇預設套件管理格式。
卸載套件
若要卸載 NuGet 套件,請遵循下列步驟:
在 [方案總管]中載入專案,選取 [專案]>[管理 NuGet 套件],然後選取 [已安裝] 索引卷標。
選取要在左窗格中卸載的套件(如有必要,請使用 [搜尋] 方塊來尋找它,然後從右窗格中選取 [卸載]。
更新套件
若要更新 NuGet 套件,請遵循下列步驟:
在 [方案總管]中載入專案,然後選取 [專案]>[管理 NuGet 套件]。 針對網站專案,請先選取 [Bin] 資料夾。
選取 [更新] 索引標籤,以查看從選取 套件來源取得可用更新的套件。 選取 [包含發行前版本,以在更新清單中包含發行前版本套件。
選取要更新的套件。 在右窗格中,從下拉式清單中選取所需的 版本,然後選取 [Update]。
針對某些套件,Update 按鈕會停用,而且會出現下列訊息:SDK 隱含參考。若要更新套件,請更新其所屬的 SDK。 此訊息指出套件是較大架構或 SDK 的一部分,且無法獨立更新。 這類套件會在內部標示
<IsImplicitlyDefined>True</IsImplicitlyDefined>
。 例如,Microsoft.NETCore.App
是 .NET Core SDK 的一部分,套件版本與應用程式所使用的運行時間架構版本不同。 若要下載新版本的 .NET Core,更新您的 .NET Core 安裝。 如需詳細資訊,請參閱 .NET Core 中繼套件和版本設定。 此案例適用於下列常用的套件:- Microsoft.AspNetCore.All
- Microsoft.AspNetCore.App
- Microsoft.NETCore.App
- NETStandard.Library
若要將多個套件更新為其最新版本,請在 [NuGet 套件] 清單中選擇它們,然後選取 [Update。
您也可以從 [已安裝 ] 索引標籤 更新個別套件。在此情況下,您也可以選取 [版本] 和 [包含發行前版本] 選項。
管理解決方案的套件
管理解決方案的套件是同時處理多個專案的便利方式:
在 Solution Manager中選取方案,然後選取 [工具]>[NuGet 套件管理員]>[管理解決方案的 NuGet 套件]。
在 [[管理方案 的 NuGet 套件] 視窗中,選取受作業影響的專案。
合併索引標籤
開發人員通常會認為在相同解決方案的不同專案中,使用不同的 NuGet 套件版本是錯誤的作法。 Visual Studio 可讓您針對 NuGet 套件使用通用版本。 若要這樣做,請使用 [NuGet 套件管理員] 視窗中的 [合併] 索引卷標,探索解決方案中不同專案使用不同版本號碼的套件的位置。
在此範例中,ClassLibrary1 專案使用 EntityFramework 6.2.0,而 ConsoleApp1 則使用 EntityFramework 6.1.0。 若要合併套件版本,請遵循下列步驟:
從 [合併] 索引標籤中,選取項目清單中要更新的專案。
在 [版本] 清單中,選取要用於所有這些專案的版本。
選擇 安裝。
NuGet 套件管理員會將選取的套件版本安裝到所有選取的專案,之後套件就不會再出現在 [合併] 索引標籤上。
套件來源
Visual Studio 會忽略套件來源的順序,使用第一個回應要求的來源的套件。 如需詳細資訊,請參閱 還原套件。 如需如何從特定來源載入套件的資訊,請參閱 套件來源對應。
若要管理 NuGet 套件來源,請遵循下列步驟:
若要變更 Visual Studio 載入套件元數據的來源,請從 套件來源 選取器選取來源。
若要管理套件來源,請選取 [設定] 圖示,或選取 [工具]>[選項]。
在 [選項] 視窗中,展開 [NuGet 套件管理員] 節點,然後選取 [套件來源]。
若要新增來源,請選取 [+]、編輯 [名稱]、在 [來源 ] 中輸入 URL 或路徑,然後選取 [更新]。
來源現在會出現在 套件來源 下拉式清單中。
若要變更套件來源,請選取它、在 [名稱] 和 [來源] 方塊中進行編輯,然後 選取 [更新]。
若要停用套件來源,請清除清單中名稱左邊的方塊。
若要移除套件來源,請選取它,然後選取 [X] 按鈕。
如果套件來源在您刪除之後重新出現,它可能會列在計算機層級或用戶層級 NuGet.config 檔案中。 如需這些檔案的位置,請參閱 Common NuGet 配置。 手動編輯檔案中的套件來源,或使用 nuget sources 命令來移除檔案中的套件來源。
NuGet 套件管理員選項控制件
當您選取套件時,NuGet 套件管理員會在 版本 選取器下方顯示可展開 選項 控件。 針對大部分的專案類型,只會提供 顯示預覽視窗 選項。
下列各節說明可用的選項。
安裝和更新選項
這些選項僅適用於特定項目類型:
相依性行為:此選項會設定 NuGet 如何決定要安裝的相依套件版本。 它有下列設定:
- 忽略相依性 略過相依性的安裝,這通常會中斷所安裝的套件。
- 最低 [預設值] 會安裝滿足主要選擇套件需求的相依套件,且其版本號碼最低。
- 最高修補程式 會安裝具有相同主要和次要版本號碼的版本,但修補程序號碼最高。 例如,如果指定 1.2.2 版,則會安裝以 1.2 開頭的最高版本
- 最高次要 會安裝具有相同主要版本號碼的版本,但次要號碼和修補程序號碼最高。 如果指定 1.2.2 版,則會安裝以 1 開頭的最高版本
- 最高 會安裝該套件的最高可用版本。
檔案衝突動作:此選項會指定 NuGet 如何處理專案或本機計算機中已存在的套件。 它有下列設定:
- 提示 指示 NuGet 詢問是否要保留或覆寫現有的套件。
- 忽略所有 會指示 NuGet 略過覆寫任何現有的套件。
- 覆寫所有 會指示 NuGet 覆寫任何現有的套件。
卸載選項
這些選項僅適用於特定項目類型:
移除相依套件:選取時,若有相依套件未被專案其他部分參考,則會移除該套件。
強制卸載,即使有相依性仍執行:選取此選項時,會卸載套件,即使該套件仍被專案參考。 此選項通常會與 移除相依性 搭配使用,以移除套件及其安裝的任何相依性。 不過,使用此選項可能會導致專案中的參考中斷。 在這種情況下,您可能需要 重新安裝這些其他套件。
相關影片
另請參閱
如需 NuGet 的詳細資訊,請參閱下列文章:
- 什麼是 NuGet?
- 套件取用工作流程
- 尋找並選擇套件
- 專案檔案中的套件參考
- 使用 .NET CLI安裝和使用套件。