Rider中Add Reference对话框为空如何添加.NET引用？

注意：该问题与「How to add com reference in Rider」问题类似，但该问题始终未获得有效解答，目前有不少用户遇到了相同问题却找不到对应解决方案。

问题现象 #

在Rider中对C#项目执行 Add -> Add Reference 操作尝试添加引用时，弹出的对话框完全为空，和官方文档描述的功能表现不一致。
典型场景：需要在默认不包含对应命名空间的控制台应用（Console Application）中，添加对System.Windows.Forms的引用。
空对话框截图：

解决方案 #

根据项目类型分情况处理：

场景1：项目为 .NET Core / .NET 5+ 版本

这是最常见的诱因，这类项目默认不引用Windows桌面开发相关的程序集，且非Windows目标框架下不会加载WinForms、WPF相关的引用条目，不属于Rider功能bug。
操作步骤：

• 右键项目，选择「Edit Project File」直接编辑csproj配置文件
• 检查第一行的SDK配置与目标框架配置：
  • 如果是.NET 5及以下版本，将SDK值从Microsoft.NET.Sdk替换为Microsoft.NET.Sdk.WindowsDesktop
  • 如果是.NET 6及以上版本，不需要修改SDK，保持Microsoft.NET.Sdk即可
• 在<PropertyGroup>节点下添加/修改以下配置：

<!-- 目标框架必须带windows后缀，否则无法引用桌面相关程序集，版本号替换为你实际使用的.NET版本即可 -->
<TargetFramework>net8.0-windows</TargetFramework>
<UseWindowsForms>true</UseWindowsForms>

• 保存csproj文件，等待Rider自动重载项目完成后，Add Reference对话框就会正常加载所有可引用的程序集，且System.Windows.Forms已经被自动引入，不需要手动再添加引用，可以直接在代码中使用对应命名空间。

场景2：项目为传统 .NET Framework 版本

这类问题一般是项目加载异常或Rider缓存损坏导致：

• 首先确认本地已经安装了对应版本的.NET Framework开发工具包，Rider右下角没有项目加载失败的提示
• 清除Rider缓存并重启：菜单栏选择File -> Invalidate Caches...，勾选所有缓存选项后确认重启，等待项目重新索引加载完成，再打开Add Reference对话框即可恢复正常。

内容的提问来源于stack exchange，提问作者Lahzey