Rider无法解析已安装NuGet包引用的问题排查咨询

按优先级从高到低操作，每步完成后检查引用是否恢复：

• 清理全量缓存后重新加载项目
  关闭Rider，直接删除解决方案根目录下的.idea文件夹、所有项目目录下的bin和obj文件夹，重新打开解决方案后等待Rider完成全量项目加载与索引，不要刚启动就操作代码。这是从Visual Studio迁移到Rider最常见的问题，VS生成的旧编译缓存、Rider首次初始化生成的损坏索引，都会导致NuGet面板显示包已安装但代码无法识别引用。
• 校验包的实际引用有效性
  不要只依赖NuGet面板的已安装标记，直接打开出问题项目的.csproj文件，确认存在对应DidiSoft包的PackageReference节点，且版本号、适配框架和项目当前配置的TargetFramework完全匹配。多目标框架项目需要额外确认，包没有被限定在特定框架版本下引用。
  顺手打开本地NuGet默认缓存路径%USERPROFILE%\.nuget\packages，找到对应DidiSoft包的文件夹，进入对应版本的lib目录检查：如果目录下只有适配.NET Framework的dll，而你的项目是.NET Core/.NET 5+版本，就会出现面板显示已安装但代码找不到命名空间的问题，本质是包和目标框架不兼容。
• 修复NuGet源凭证配置遗留问题
  你之前将Use Credentialed Providers设置为None的临时方案，大概率只让Rider拉取到了包的元数据，实际的nupkg包没有完整下载。打开Rider的NuGet设置，找到你配置的DidiSoft源，直接在源配置项中填写正确的用户名密码，不要依赖弹窗输入凭证。保存后点击NuGet设置面板顶部的Clear All NuGet Caches清空所有损坏缓存，再重新执行强制还原。
  额外检查NuGet.Config的配置层级：解决方案目录下的配置优先级最高，需要认证的自定义源不要只配置在用户全局NuGet配置中，容易出现权限继承异常。
• 校验Rider的构建工具链配置
  刚从VS迁移的环境很容易出现MSBuild路径识别错误：打开Rider设置 -> Build, Execution, Deployment -> Toolset and Build，确认选中的.NET SDK是你项目对应版本的正式版SDK，MSBuild版本和SDK版本匹配，不要让工具自动fallback到VS自带的旧版本MSBuild。修改后重启Rider重新加载解决方案。
  如果上述操作无效，可以在解决方案资源管理器中右键卸载出问题的项目，再重新加载，触发单项目的引用重解析流程。

• 检查对应包的PackageReference节点是否配置了PrivateAssets、ExcludeAssets属性，如果错误将编译相关资产排除，包即使安装成功也不会进入编译链路，正常安装的包这两个属性留空走默认值即可。
• 检查解决方案文件夹的权限，如果当前Windows账号对项目目录没有写入权限，Rider无法生成引用索引，也会出现识别失败的问题，给当前账号分配目录完全控制权限即可。
• 核对包的实际命名空间：DidiSoft不同版本的包命名空间存在差异，部分版本根命名空间为DidiSoft而非DidX，可以双击NuGet面板中已安装的包，直接查看包内程序集暴露的命名空间列表，避免装错版本、错认命名空间。

• 执行强制还原时不要关闭NuGet控制台，完整保留输出内容，很多包下载不完整、哈希不匹配、框架不兼容的警告不会显示在主界面错误列表中，只会输出在NuGet控制台。
• 打开Rider日志文件（菜单选择Help -> Show Log in Explorer），筛选解决方案加载阶段带NuGet、ResolveReference关键字的日志，可以直接看到Rider解析引用失败的具体原因，比如找不到dll、dll加载失败、版本冲突等。
• 切到项目根目录打开命令行，执行dotnet restore --force后再运行dotnet build：如果命令行编译直接报错，说明问题和Rider无关，是包配置、框架兼容本身的问题，按命令行报错修复即可；如果命令行编译可以正常通过，只有Rider中代码飘红，说明是Rider本地索引损坏，选择File -> Invalidate Caches... 勾选所有选项重启Rider即可解决。

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