参加你附近的 ,了解 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 包