Visual Studio Code 中的 NuGet

NuGet 是 .NET 的包管理器。它定义了 .NET 包的创建、托管和使用方式，同时为每个功能提供工具。NuGet 还代表项目管理依赖树，所以你只需要专注于项目中直接使用的包。

在Visual Studio Code中，你可以直接从C# Dev Kit解决方案资源管理器管理NuGet包，或者使用命令调色板。

想了解更多关于 NuGet 的信息，请访问 NuGet 文档。

C# 开发套件中的 NuGet 命令

在 C# 开发套件中，你可以通过两种方式执行 NuGet 包作：

  • 使用命令调色板（⇧⌘P（Windows，Linux Ctrl+Shift+P）)

  • 在 C# 开发工具包解决方案资源管理器中右键点击

以下章节将介绍如何使用这两个NuGet命令，同时使用这两种方法。

添加一个包

  1. 要向你的项目添加 NuGet 包，请在命令面板中使用命令 NuGet： Add NuGet Package（⇧⌘P（Windows，Linux Ctrl+Shift+P））。

    命令面板中显示“NuGet： Add NuGet Package”命令的截图

  2. 如果你的解决方案中有多个项目，系统会要求你选择想添加该包的项目。

    显示快速选择菜单的截图，带有下拉选项“Project”和“Project2”

  3. 接下来，输入搜索词，按名称搜索NuGet套餐。

    截图显示命令调色板搜索栏，带有占位文字，写着“输入搜索词以搜索 NuGet 包。”

    快速选择会显示一份示例 NuGet 包的列表供你选择。

    快速选择下拉菜单的截图，带有占位文字：“选择 NuGet 包”。快速选择选项会显示一份示例 NuGet 包的列表供你选择。

  4. 接下来，选择你想应用的版本。

    快速选择下拉菜单的截图，带有占位文字：“选择NuGet包版本”。快速选择选项会显示一份示例 NuGet 包版本列表，供你选择。

  5. 选择包和版本号后，C# 开发工具包会将其添加到项目中，并更新项目文件和参考。

更新软件包

  1. 要更新项目中的 NuGet 包，请使用命令面板中的 NuGet： Update NuGet Package（⇧⌘P（Windows，Linux Ctrl+Shift+P））命令。

  2. 如果你的解决方案中有多个项目，系统会要求你选择包含你想更新的包的项目。

  3. 接下来，从项目中当前安装且有更新的包列表中选择要更新的包。如果你的方案中没有可用的软件包，你会看到一条通知。

  4. 最后，你可以从可选版本下拉列表中选择想要更新的版本。

    快速选择下拉菜单的截图，带有占位文字：“选择NuGet包版本”。快速选择选项会显示一份示例 NuGet 包的列表供你选择。列表中有指示器显示用户项目当前安装的版本（“当前”）和最新可用版本（“最新”）

  5. C# 开发工具包随后执行必要的修改，并更新你的项目文件和参考。

移除一个包裹

  1. 要从你的项目中移除 NuGet 包，请在命令面板中使用命令 NuGet： Remove NuGet Package（⇧⌘P（Windows，Linux Ctrl+Shift+P））。

  2. 如果你的解决方案中有多个项目，系统会要求你选择想从哪个项目中移除一个包。

  3. 接下来，选择你想从当前安装在项目中的包列表中移除哪个包。

  4. C# 开发工具包随后执行必要的修改，并更新你的项目文件和参考。

包含预发布的软件包版本

如果你想更新或添加 NuGet 包的预发布版本，首先需要将“包含预发布包版本”设置为 true。

你可以在设置>文件>偏好设置（⌘， （Windows， Linux Ctrl+，））中找到这个选项，并搜索 nuget.includePrereleasePackageVersions到确实如此.

依赖管理

自动 NuGet 恢复

对于 .NET 项目，包还原在你从模板创建项目、构建、加载或对 SDK 风格项目进行修改时会自动进行。你可以在输出面板的进度和日志中查看。

自动 NuGet 包还原

对于使用<PackageReference>你可以在 Visual Studio Code 的解决方案资源管理器部分看到包的引用。

解决方案探索器中的包引用

在恢复时或运行构建时无法正确安装的包，会在解决方案资源管理器中显示错误图标。

注意：目前，你无法右键点击项目来管理你的 NuGet 包，Visual Studio Code 中也没有 NuGet 包管理器的用户界面。

有关管理包的更多信息，请参见“用dotnet CLI安装和管理NuGet包”。