參加你附近的 ,瞭解 VS Code 中的 AI 輔助開發。

Visual Studio Code 中的 NuGet

NuGet 是 .NET 的包管理器。它定義瞭如何建立、託管和使用 .NET 的包,同時為這些功能中的每一項提供了工具。NuGet 還代表專案管理依賴關係樹,因此你只需關注專案中直接使用的包。

在 Visual Studio Code 中,你可以直接從 C# 開發工具包解決方案資源管理器管理 NuGet 包,也可以使用命令面板進行管理。

若要詳細瞭解 NuGet,請訪問 NuGet 文件

C# 開發工具包中的 NuGet 命令

在 C# 開發工具包中,你可以透過以下兩種方式之一執行 NuGet 包操作:

  • 使用命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P))

  • 在 C# 開發工具包解決方案資源管理器中右鍵單擊

以下各節介紹如何使用這兩種方法來使用每個 NuGet 命令。

新增包

  1. 若要將 NuGet 包新增到專案,請在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用命令 NuGet: Add NuGet Package

    Screenshot showing command 'NuGet: Add NuGet Package' in the command palette

  2. 如果解決方案中有多個專案,系統會要求你選擇要將包新增到哪個專案。

    Screenshot showing quickpick menu with dropdown options "Project" and "Project2"

  3. 接下來,輸入搜尋詞以按名稱搜尋 NuGet 包。

    Screenshot showing command palette search bar with placeholder text that reads "Enter a search term to search for a NuGet package."

    “快速選取”會顯示一個可供選擇的 NuGet 包示例列表。

    Screenshot showing quickpicks dropdown menu with placeholder text that reads: "Select a NuGet package". The quickpick options show a list of example NuGet packages to choose from.

  4. 接下來,選擇要應用的版本。

    Screenshot showing quickpicks dropdown menu with placeholder text that reads: "Select a NuGet package version". The quickpick options show a list of example NuGet package versions to choose from.

  5. 選擇包和版本號後,C# 開發工具包會將其新增到你的專案中,並更新你的專案檔案和引用。

更新包

  1. 若要更新專案中的 NuGet 包,請在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用命令 NuGet: Update NuGet Package

  2. 如果解決方案中有多個專案,系統會要求你選擇包含要更新的包的專案。

  3. 接下來,從專案中當前已安裝且有可用更新的包列表中,選擇要更新的包。如果解決方案中沒有包有可用更新,你將看到一條通知此情況的訊息。

  4. 最後,你可以從可用版本的下拉列表中選擇要將包更新到的版本。

    Screenshot showing quickpicks dropdown menu with placeholder text that reads: "Select a NuGet package version". The quickpick options show a list of example NuGet packages to choose from. There are indicators on the list to show which version is currently installed in the users project ("current"), and which is the latest available version ("latest")

  5. 然後,C# 開發工具包會執行必要的更改並更新你的專案檔案和引用。

刪除包

  1. 若要從專案中刪除 NuGet 包,請在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用命令 NuGet: Remove NuGet Package

  2. 如果解決方案中有多個專案,系統會要求你選擇要從中刪除包的專案。

  3. 接下來,從專案中當前已安裝的包列表中,選擇要刪除的包。

  4. 然後,C# 開發工具包會執行必要的更改並更新你的專案檔案和引用。

包括預發行包版本

如果你希望更新或新增 NuGet 包的預發行版本,首先需要將 Include Prerelease Package Versions 設定為 true

你可以在 File > Preferences > Settings (⌘, (Windows, Linux Ctrl+,)) 下找到此選項,並將 nuget.includePrereleasePackageVersions 搜尋並設定為 true

依賴項管理

自動 NuGet 還原

對於 .NET 專案,當你從模板建立專案、生成、載入或對 SDK 風格的專案進行更改時,會自動進行包還原。你可以在“輸出”面板中檢視進度和日誌。

Automatic NuGet package restore

對於使用 <PackageReference> 的專案,你可以在 Visual Studio Code 的解決方案資源管理器部分檢視包引用。

Package references in the Solution Explorer

在還原或執行生成時未能正確安裝的包,將在解決方案資源管理器中顯示錯誤圖示。

注意:目前,你無法透過右鍵單擊專案來管理 NuGet 包,並且 Visual Studio Code 中沒有 NuGet 包管理器使用者介面。

有關管理包的更多資訊,請參閱使用 dotnet CLI 安裝和管理 NuGet 包