Visual Studio 2019/2022 NUnit测试无法通过NUnit适配器运行求助

故障根因分类及对应解决方法 #

• 测试适配器加载优先级冲突
  打开VS菜单栏 工具 > 选项 > 测试 > 常规，确认「测试适配器设置」中NUnit3适配器未被禁用，取消MSTest适配器的强制优先配置。如果项目根目录存在自定义.runsettings配置文件，要么直接删除重置配置，要么在文件中显式指定NUnit适配器加载路径：

  <RunSettings>
    <TestAdaptersPaths>
      <Add Path="%USERPROFILE%\.nuget\packages\nunit3testadapter\你的适配器版本号\build" />
    </TestAdaptersPaths>
  </RunSettings>
  

• NuGet包冲突或缓存损坏
  先执行命令清理本地NuGet缓存：
  dotnet nuget locals all --clear
  随后卸载项目中所有测试相关NuGet包，按顺序重新安装适配VS2022的稳定版本：
  1. Microsoft.NET.Test.SDK ≥ 17.0.0
  2. NUnit ≥ 3.13.3
  3. NUnit3TestAdapter ≥ 4.2.1
     全程不要安装MSTest.TestAdapter、MSTest.TestFramework两类包，避免主动引入MSTest执行环境。
• 项目文件残留MSTest配置
  右键测试项目点击「编辑项目文件」，删除所有MSTest相关的PackageReference导入配置，同时确认项目生成目标平台与NUnit适配器适配平台一致，避免32位/64位不匹配导致适配器加载失败。
• VS测试资源管理器缓存异常
  关闭所有VS窗口，删除路径 %LOCALAPPDATA%\Microsoft\VisualStudio\17.0_xxxx\ComponentModelCache 下的全部缓存文件，重启VS后重新生成解决方案即可。

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