JetBrains Rider 2025.2 Help

使用 NuGet 包

您可以通过 NuGet 窗口 Alt+Shift+7 和 NuGet 快速列表 Ctrl+P, N 安装、更新和移除 NuGet 包。

浏览已安装和可用的 NuGet 包

默认情况下,窗口的 软件包 选项卡显示整个解决方案中安装的所有包,但您可以更改视图以仅显示特定项目的包。 为此,请使用搜索字段旁边的范围选择器:

JetBrains Rider:选择一个项目以管理 NuGet 包

所选范围的可用包始终显示在已安装包的下方。

从其他已安装包引用的包显示在 隐式安装 类别中。 它们的版本显示在括号中,因为您无法升级或降级它们。 要了解哪个包引用了隐式安装的包,请右键点击它并选择 快速 NuGet 文档 或按 Ctrl+Q

您可以在 软件包 选项卡的左侧选择已安装或可用的包,并使用右侧查看包的详细信息,以及在特定项目中安装、升级/降级或移除包:

Rider:管理 NuGet 包

还原和升级 NuGet 包

Rider 提供了两种还原 NuGet 包的算法:

  • 正常 — 调用标准的 NuGet 还原机制,这可能会很慢,尤其是在 .NET 项目中。 它可以通过主菜单 (工具 | NuGet | NuGet 恢复 )、NuGet 快速列表 Ctrl+P, N ,以及点击 NuGet 窗口工具栏上的 还原 还原 来使用。

  • 强制 — 执行一些启发式方法以确定应还原哪些包。 “强制”算法几乎可以瞬间完成,但在某些情况下可能无法还原某些包。 工具 | NuGet | 强制还原 NuGet )或在 NuGet 快速列表 Ctrl+P, N 中。

当您打开一个解决方案时,Rider 会自动应用“轻量”算法来还原缺失的包。 如果需要,您可以在 NuGet 设置页面更改自动还原行为,您也可以通过点击 NuGet 窗口工具栏上的 NuGet 设置 NuGet 设置 打开该页面。

要升级已安装的包,请点击 NuGet 窗口工具栏上的 升级解决方案中的包 升级解决方案中的包 ,然后选择要升级的包。

或者,您可以在 NuGet 窗口的左侧选择一个已安装的包,在右侧选择所需的版本,然后将特定项目升级/降级到此包版本。

查找并安装 NuGet 包

要查找 NuGet 包,请使用搜索字段和 可用包 列表,该列表显示在 已安装包 列表下方。

在搜索字段中,您可以输入包名称进行查找,或使用前缀: T: 查找类型, N: 查找命名空间。

默认情况下,Rider 会搜索所有可用的 包源 ,但您可以使用相应的选择器限制搜索范围:

Rider:选择 NuGet 包源

点击某个包源将选择该源并取消选择所有其他源。 您可以 Shift 点击以选择多个源,或点击 所有 Feed 以选择所有源。

安装或升级/降级 NuGet 包

  1. 按照上述描述找到所需的包,并在 选项卡的左侧部分选择它。

  2. 在选项卡的右侧部分,选择您希望安装所选包的项目。 如果您的解决方案包含过多项目,您可能需要使用工具栏上的范围选择器来显示特定项目并隐藏所有其他项目。

  3. 使用工具栏上的 预发布 复选框显示或隐藏包的预发布版本。

  4. 在右侧选项卡中使用 版本选择器 选择所需的包版本。

  5. 在安装所选包之前,您可能希望检查将安装哪些依赖包。 为此,请展开右侧的 框架和依赖项

    Rider:所选 NuGet 包的依赖项
  6. 根据所选包版本以及所选包是否已安装在所选项目中,您将能够安装、升级或降级该包。

    安装新包后,您将在编辑器中看到其 readme.txt 文件,以便您可以检查安装后是否需要执行任何其他步骤。

    如果包中实现了 配置文件/XDT 转换 ,JetBrains Rider 将运行它们以帮助添加所需条目,例如到 App.config Web.config 文件。

开始搜索 NuGet 包的最简单方法是使用对应的 Alt+Enter 操作,该操作在未解析的命名空间中可用:

使用 JetBrains Rider 按命名空间查找 NuGet 包

……以及类型:

使用 JetBrains Rider 按类型查找 NuGet 包

无论如何,JetBrains Rider 都会打开 NuGet 窗口,您将在其中看到包含所需类型或命名空间的所有包。

管理包源

在 NuGet 窗口的 选项卡中,Rider 列出了在您的计算机上发现的所有 NuGet 配置文件。 您可以在右侧面板中添加、删除或编辑所选配置文件的包源,或点击这些文件以在编辑器中打开它们。

如果需要,您可以通过编辑配置文件的 packageSources 部分手动添加或删除包源。 例如:

<packageSources> <add key="My online package source" value="https://some.address/"/> <add key="My local package source" value="C:\NuGetPackages\"/> </packageSources>

私有 NuGet 源的凭据提供程序

JetBrains Rider 允许您使用不同的身份验证方法登录到私有 NuGet 源。

用户名/密码组合的身份验证提示

在 NuGet 窗口的 选项卡中,您可以编辑或添加源,并以用户名/密码组合的形式添加凭据。

私有源的 URL 通常与团队成员共享在解决方案文件旁边的 NuGet.config 文件中,以便团队中的每个人都可以连接到此类私有源。 首次加载需要还原包的此类解决方案时,JetBrains Rider 将提示输入凭据。

当凭据正确时,它们会存储在 JetBrains Rider 的密码存储中,因此每次访问 NuGet 源时,您无需重新输入凭据。 密码存储可在 外观与行为 | 系统设置 | 密码 设置页面&#xa0; Ctrl+Alt+S 上配置。

JetBrains Rider 还集成了 MyGetVisual Studio Team Services (VSTS)的凭据提供程序。

使用身份验证插件

对于使用基于插件的身份验证方法的私有源,例如 由 Azure Artifacts 提供的 ,您需要在 构建、执行、部署 | NuGet 设置页面&#xa0; Ctrl+Alt+S 上更改 使用凭据提供程序 首选项为 NuGet/.NET CLI 插件NuGet/.NET CLI 插件,然后 Rider 集成 (如果您使用不同的身份验证方法),然后重新启动 JetBrains Rider。

启用身份验证插件支持后,将监控 %USERPROFILE%\.nuget\plugins (Windows)和 $HOME/.nuget/plugins (Linux/macOS)路径中适用的凭据提供程序插件,JetBrains Rider 将使用这些插件执行必要的身份验证。

NuGet 选项

您可以在 NuGet 设置页面中配置 NuGet 首选项,您可以通过点击 NuGet 窗口中的 NuGet 设置 NuGet 设置 或通过 Rider 设置中的 构建、执行、部署 | NuGet Ctrl+Alt+S 打开该页面。

管理 NuGet 缓存

NuGet 缓存所有已下载的包,以便在没有互联网连接时仍可使用,并防止多次下载相同的包。

使用 Rider,您可以在 NuGet 窗口的 文件夹 选项卡中查看 NuGet 缓存的位置并清除选定的位置。 清除 NuGet 缓存是安全的,不会影响已安装在项目中的包。

编辑 NuGet 配置文件

如果需要,您还可以手动编辑 NuGet 配置文件—— NuGet.Config packages.config *.nuspec 。 大多数代码辅助功能,包括语法验证和 代码补全 ,均可供您使用。

JetBrains Rider:在 NuGet 配置文件中的编码辅助

NuGet 快速列表

最常用的操作可在 NuGet 快速列表中找到——Ctrl+P, N工具 | NuGet | NuGet 快速列表

JetBrains Rider:NuGet 快速列表
最后修改日期: 2025年 9月 26日