顶级程序触发SA1516警告未显示对应文件 无法定位修复位置

警告信息中CSC的含义 #

CSC是*C# Compiler（即C#编译器）*的缩写，对应.NET SDK内置的C#编译程序csc.exe，不属于项目里的业务代码文件。出现这个标识的原因是：当SA1516警告在顶级语句场景下触发时，旧版本StyleCop分析器没有正确绑定警告对应的源文件位置信息，编译器只能将警告来源标记为自身。

无文件信息无法跳转定位的解决方法 #

• 升级StyleCop.Analyzers NuGet包至最新稳定版：顶级语句场景下SA1516不输出关联文件位置是旧版本分析器的已知Bug，升级完成后警告会自动关联正确的文件与代码行，恢复点击跳转能力。
• 优先排查顶级语句入口文件：这类无位置信息的SA1516警告，绝大多数触发于项目的顶级语句入口文件（一般是项目根目录下的Program.cs），重点检查以下位置的空行分隔是否符合规则：
  • 文件头部的using指令块和后续顶级代码之间是否保留空行
  • 顶级作用域下的不同元素（全局执行语句、自定义类型定义、本地函数、特性标注）之间是否保留空行
    按规则补全空行后重新编译，即可确认警告是否消除。
• 借助IDE自动格式化修复：打开顶级语句入口文件，触发IDE的代码自动格式化（Visual Studio默认快捷键为Ctrl+K, Ctrl+D，Rider默认快捷键为Ctrl+Alt+Enter），只要IDE已关联StyleCop规则，格式化过程会自动补齐所有符合SA1516要求的元素分隔空行。
• 从详细生成日志获取定位信息：将开发工具的生成日志详细程度调整为「详细」，重新生成项目后在生成日志中搜索SA1516关键词，即可查到该警告对应的完整文件路径和行号，手动定位修改即可。

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