使用 NuGet 套件管理員在 Visual Studio 中安裝和管理套件

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 套件，請遵循下列步驟：

1. 在 [方案總管]中載入專案，然後選取 [專案]>[管理 NuGet 套件]。

   NuGet 套件管理員 視窗隨即開啟。

2. 從目前選取的來源選取 [瀏覽] 標籤，以依受歡迎程度顯示套件（請參閱 套件來源）。

   • 若要搜尋特定套件，請使用左上方的搜尋方塊。
   • 每個套件標識子旁邊可能會顯示縮寫資訊，以協助識別正確的套件，並根據選取的套件來源而有所不同。 範例包括套件下載計數、作者或擁有者配置檔超連結。

   注意

   在 Visual Studio 17.11 和更高版本中，當選定的套件來源支援時，套件擁有者會顯示為個人資料超連結。 套件擁有權是由套件來源所定義。 例如，請參閱 在 nuget.org 上管理套件擁有者。

   在 Visual Studio 17.10 和更早版本中，會顯示套件 作者 元數據，顯示為純文本。 如需詳細資訊，請參閱 作者套件元資料。

   • 選取套件以查看詳細的套件資訊。 右側的詳細數據窗格隨即出現，並可讓您選取要安裝的版本。 您可以在 [套件詳細資訊] 索引標籤中看到套件元數據、擁有者、作者、授權等相關信息，以及在 [README] 索引標籤中查看套件自述檔（如果套件作者有提供）。

3. 在右窗格中，從下拉式清單中選取 版本。 如果您要在 [版本] 清單中包含發行前版本，請選取 [包含發行前版本] 。

4. 若要安裝 NuGet 套件，請選取 [安裝]。 系統可能會要求您接受授權條款，或提示您確認安裝。

   Visual Studio 會在專案中安裝套件及其相依性。 安裝完成時，新增的套件會出現在 [已安裝的 ] 索引標籤上。您也可以在 [方案總管] [方案總管] 中，於專案的 [相依性>套件] 節點中找到套件。 安裝套件之後，您可以使用 using 語句在項目中參考它。

5. （選擇性）NuGet 有兩種格式，專案可以使用套件：PackageReference 和 packages.config。若要設定預設格式，請選取 [工具]>[選項]，展開 [NuGet 套件管理員]，選取 [一般]，然後選擇 [預設套件管理格式]。 如需詳細資訊，請參閱 選擇預設套件管理格式。

卸載套件

若要卸載 NuGet 套件，請遵循下列步驟：

1. 在 [方案總管]中載入專案，選取 [專案]>[管理 NuGet 套件]，然後選取 [已安裝] 索引卷標。

2. 選取要在左窗格中卸載的套件（如有必要，請使用 [搜尋] 方塊來尋找它，然後從右窗格中選取 [卸載]。

   

更新套件

若要更新 NuGet 套件，請遵循下列步驟：

1. 在 [方案總管]中載入專案，然後選取 [專案]>[管理 NuGet 套件]。 針對網站專案，請先選取 [Bin] 資料夾。

2. 選取 [更新] 索引標籤，以查看從選取 套件來源取得可用更新的套件。 選取 [包含發行前版本，以在更新清單中包含發行前版本套件。

3. 選取要更新的套件。 在右窗格中，從下拉式清單中選取所需的 版本，然後選取 [Update]。

   

4. 針對某些套件，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

   

5. 若要將多個套件更新為其最新版本，請在 [NuGet 套件] 清單中選擇它們，然後選取 [Update。

6. 您也可以從 [已安裝 ] 索引標籤 更新個別套件。在此情況下，您也可以選取 [版本] 和 [包含發行前版本] 選項。

管理解決方案的套件

管理解決方案的套件是同時處理多個專案的便利方式：

1. 在 Solution Manager中選取方案，然後選取 [工具]>[NuGet 套件管理員]>[管理解決方案的 NuGet 套件]。

2. 在 [[管理方案 的 NuGet 套件] 視窗中，選取受作業影響的專案。

   

合併索引標籤

開發人員通常會認為在相同解決方案的不同專案中，使用不同的 NuGet 套件版本是錯誤的作法。 Visual Studio 可讓您針對 NuGet 套件使用通用版本。 若要這樣做，請使用 [NuGet 套件管理員] 視窗中的 [合併] 索引卷標，探索解決方案中不同專案使用不同版本號碼的套件的位置。

在此範例中，ClassLibrary1 專案使用 EntityFramework 6.2.0，而 ConsoleApp1 則使用 EntityFramework 6.1.0。 若要合併套件版本，請遵循下列步驟：

1. 從 [合併] 索引標籤中，選取項目清單中要更新的專案。

2. 在 [版本] 清單中，選取要用於所有這些專案的版本。

3. 選擇 安裝。

   NuGet 套件管理員會將選取的套件版本安裝到所有選取的專案，之後套件就不會再出現在 [合併] 索引標籤上。

套件來源

Visual Studio 會忽略套件來源的順序，使用第一個回應要求的來源的套件。 如需詳細資訊，請參閱 還原套件。 如需如何從特定來源載入套件的資訊，請參閱 套件來源對應。

若要管理 NuGet 套件來源，請遵循下列步驟：

1. 若要變更 Visual Studio 載入套件元數據的來源，請從 套件來源 選取器選取來源。

   

2. 若要管理套件來源，請選取 [設定] 圖示，或選取 [工具]>[選項]。

   

3. 在 [選項] 視窗中，展開 [NuGet 套件管理員] 節點，然後選取 [套件來源]。

   

4. 若要新增來源，請選取 [+]、編輯 [名稱]、在 [來源 ] 中輸入 URL 或路徑，然後選取 [更新]。

   來源現在會出現在 套件來源 下拉式清單中。

5. 若要變更套件來源，請選取它、在 [名稱] 和 [來源] 方塊中進行編輯，然後 選取 [更新]。

6. 若要停用套件來源，請清除清單中名稱左邊的方塊。

7. 若要移除套件來源，請選取它，然後選取 [X] 按鈕。

   如果套件來源在您刪除之後重新出現，它可能會列在計算機層級或用戶層級 NuGet.config 檔案中。 如需這些檔案的位置，請參閱 Common NuGet 配置。 手動編輯檔案中的套件來源，或使用 nuget sources 命令來移除檔案中的套件來源。

NuGet 套件管理員選項控制件

當您選取套件時，NuGet 套件管理員會在 版本 選取器下方顯示可展開 選項 控件。 針對大部分的專案類型，只會提供 顯示預覽視窗 選項。

下列各節說明可用的選項。

安裝和更新選項

這些選項僅適用於特定項目類型：

• 相依性行為：此選項會設定 NuGet 如何決定要安裝的相依套件版本。 它有下列設定：

  • 忽略相依性 略過相依性的安裝，這通常會中斷所安裝的套件。
  • 最低 [預設值] 會安裝滿足主要選擇套件需求的相依套件，且其版本號碼最低。
  • 最高修補程式 會安裝具有相同主要和次要版本號碼的版本，但修補程序號碼最高。 例如，如果指定 1.2.2 版，則會安裝以 1.2 開頭的最高版本
  • 最高次要 會安裝具有相同主要版本號碼的版本，但次要號碼和修補程序號碼最高。 如果指定 1.2.2 版，則會安裝以 1 開頭的最高版本
  • 最高 會安裝該套件的最高可用版本。

• 檔案衝突動作：此選項會指定 NuGet 如何處理專案或本機計算機中已存在的套件。 它有下列設定：

  • 提示 指示 NuGet 詢問是否要保留或覆寫現有的套件。
  • 忽略所有 會指示 NuGet 略過覆寫任何現有的套件。
  • 覆寫所有 會指示 NuGet 覆寫任何現有的套件。

卸載選項

這些選項僅適用於特定項目類型：

• 移除相依套件：選取時，若有相依套件未被專案其他部分參考，則會移除該套件。

• 強制卸載，即使有相依性仍執行：選取此選項時，會卸載套件，即使該套件仍被專案參考。 此選項通常會與 移除相依性 搭配使用，以移除套件及其安裝的任何相依性。 不過，使用此選項可能會導致專案中的參考中斷。 在這種情況下，您可能需要 重新安裝這些其他套件。

相關影片

• 在 Channel 9 和 YouTube上尋找 NuGet 影片。

另請參閱

如需 NuGet 的詳細資訊，請參閱下列文章：

• 什麼是 NuGet？
• 套件取用工作流程
• 尋找並選擇套件
• 專案檔案中的套件參考
• 使用 .NET CLI安裝和使用套件。