C#自定义代码分析器调试：单元测试正常但实际项目无报错

一、直接附加调试到编译器进程 #

• 打开分析器的解决方案，在关键逻辑处（比如Initialize方法、诊断触发的代码块）设置断点
• 定位并附加到编译进程：
  1. 在目标项目的命令行执行dotnet build -v diag，从日志中找到编译时启动的csc.exe进程ID；或者在VS的输出窗口（设置为「详细」级别）查看编译相关进程信息
  2. 在分析器的VS实例中，点击「调试」→「附加到进程」，选中对应的csc.exe（注意区分32位/64位进程）
  3. 重新编译目标项目，观察断点是否命中，以此确认分析器是否被初始化、核心逻辑是否执行

二、验证分析器加载状态 #

• 执行dotnet build -v diag，搜索分析器类名PluginAnalyzer：
  • 确认是否存在Loaded analyzer from ...的日志条目，路径是否指向NuGet包中的正确位置
  • 排查是否有加载失败的错误日志（比如依赖库缺失、.NET版本不兼容）
• 在VS的目标项目依赖树中，展开「依赖项」→「分析器」，检查MyAnalyzer下是否显示PluginAnalyzer：如果带有感叹号，说明分析器加载异常

三、排查项目配置与环境差异 #

• 对比单元测试项目和目标项目的核心配置：
  • 检查<LangVersion>是否一致：如果分析器依赖特定C#版本的语法特性，目标项目的语言版本过低会导致语法节点匹配失败
  • 确认规则启用状态：检查项目的.editorconfig文件或csproj中的<DiagnosticSeverity>配置，是否将你的自定义规则级别设为None，导致诊断结果被忽略
  • 核对NuGet引用配置：确认<IncludeAssets>analyzers</IncludeAssets>是否满足分析器的依赖需求，如果分析器需要额外的运行时依赖，可能需要调整IncludeAssets的范围
• 检查编译模式：目标项目如果是Release模式，确认是否有配置禁用了分析器（部分项目会在Release下关闭代码分析）

四、验证分析器触发逻辑的匹配条件 #

• 对比单元测试用例和目标项目的代码：确认目标项目中存在符合分析器规则的代码模式，比如分析器检测特定方法调用，目标项目是否真的存在该调用
• 添加日志辅助排查：
  1. 在分析器的核心逻辑中，加入System.Diagnostics.Trace.WriteLine()输出关键信息（比如进入分析方法、匹配到的语法节点）
  2. 用dotnet build /p:DebugType=full编译目标项目，通过DebugView工具捕获Trace输出，或者查看编译日志中的相关信息，确认逻辑是否执行到了诊断触发的步骤

五、检查规则的级别配置 #

• 打开目标项目的「项目属性」→「代码分析」，确认你的自定义规则是否被启用，且级别设置为「警告」或「错误」
• 检查.editorconfig文件中是否存在类似dotnet_diagnostic.XXX.severity = none的配置（XXX为你的规则ID），这种配置会直接覆盖规则的默认级别

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