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 命令。
添加包
-
若要将 NuGet 包添加到项目,请在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用命令 NuGet: Add NuGet Package。
-
如果解决方案中有多个项目,系统会要求你选择要将包添加到哪个项目。
-
接下来,输入搜索词以按名称搜索 NuGet 包。
“快速选取”会显示一个可供选择的 NuGet 包示例列表。
-
接下来,选择要应用的版本。
-
选择包和版本号后,C# 开发工具包会将其添加到你的项目中,并更新你的项目文件和引用。
更新包
-
若要更新项目中的 NuGet 包,请在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用命令 NuGet: Update NuGet Package。
-
如果解决方案中有多个项目,系统会要求你选择包含要更新的包的项目。
-
接下来,从项目中当前已安装且有可用更新的包列表中,选择要更新的包。如果解决方案中没有包有可用更新,你将看到一条通知此情况的消息。
-
最后,你可以从可用版本的下拉列表中选择要将包更新到的版本。
-
然后,C# 开发工具包会执行必要的更改并更新你的项目文件和引用。
删除包
-
若要从项目中删除 NuGet 包,请在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用命令 NuGet: Remove NuGet Package。
-
如果解决方案中有多个项目,系统会要求你选择要从中删除包的项目。
-
接下来,从项目中当前已安装的包列表中,选择要删除的包。
-
然后,C# 开发工具包会执行必要的更改并更新你的项目文件和引用。
包括预发行包版本
如果你希望更新或添加 NuGet 包的预发行版本,首先需要将 Include Prerelease Package Versions 设置为 true。
你可以在 File > Preferences > Settings (⌘, (Windows, Linux Ctrl+,)) 下找到此选项,并将 nuget.includePrereleasePackageVersions
搜索并设置为 true
。
依赖项管理
自动 NuGet 还原
对于 .NET 项目,当你从模板创建项目、生成、加载或对 SDK 风格的项目进行更改时,会自动进行包还原。你可以在“输出”面板中查看进度和日志。
对于使用 <PackageReference>
的项目,你可以在 Visual Studio Code 的解决方案资源管理器部分查看包引用。
在还原或运行生成时未能正确安装的包,将在解决方案资源管理器中显示错误图标。
注意:目前,你无法通过右键单击项目来管理 NuGet 包,并且 Visual Studio Code 中没有 NuGet 包管理器用户界面。
有关管理包的更多信息,请参阅使用 dotnet CLI 安装和管理 NuGet 包。