🚀 在 VS Code 中免费获取

Visual Studio Code 中的 NuGet

NuGet 是 .NET 的包管理器。它定义了如何创建、托管和使用 .NET 包,同时为这些功能提供工具。NuGet 还代表项目管理依赖树,因此您只需专注于项目中直接使用的包。

在 Visual Studio Code 中,您可以直接从 C# Dev Kit 解决方案资源管理器或使用命令面板来管理 NuGet 包。

要了解有关 NuGet 的更多信息,请访问 NuGet 文档

C# Dev Kit 中的 NuGet 命令

在 C# Dev Kit 中,您可以通过以下两种方式之一执行 NuGet 包操作

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

  • 在 C# Dev Kit 解决方案资源管理器中右键单击

以下各节介绍如何使用这两种方法来使用每个 NuGet 命令。

添加包

  1. 要将 NuGet 包添加到您的项目,请在命令面板中使用命令 NuGet: 添加 NuGet 包 (⇧⌘P (Windows, Linux Ctrl+Shift+P))。

    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# Dev Kit 会将其添加到您的项目并更新您的项目文件和引用。

更新包

  1. 要更新项目中的 NuGet 包,请在命令面板中使用命令 NuGet: 更新 NuGet 包 (⇧⌘P (Windows, Linux Ctrl+Shift+P))。

  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# Dev Kit 执行必要的更改并更新您的项目文件和引用。

移除包

  1. 要从您的项目中移除 NuGet 包,请在命令面板中使用命令 NuGet: 移除 NuGet 包 (⇧⌘P (Windows, Linux Ctrl+Shift+P))。

  2. 如果您的解决方案中有多个项目,系统会要求您选择要从中移除包的项目。

  3. 接下来,从当前安装在您的项目中的包列表中选择要移除的包。

  4. 然后,C# Dev Kit 执行必要的更改并更新您的项目文件和引用。

包括预发布包版本

如果您希望更新或添加 NuGet 包的预发布版本,您首先需要将包括预发布包版本设置为 true

您可以在文件 > 首选项 > 设置 (⌘, (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 包