配置sonar.exclusions无法排除Delphi文件的问题咨询

可能的原因及排查解决步骤 #

• 路径匹配规则校验
  Sonar的排除路径基于sonar.sources的相对路径，Windows环境下Sonar可能对大小写敏感，若文件名实际是File1.pas但配置写file1.pas，会导致匹配失败。可以尝试明确路径格式：

  sonar.exclusions=./file1.pas,./file2.pas,./file3.pas
  

  或用通配符兼容更复杂场景：

  sonar.exclusions=**/file1.pas,**/file2.pas
  

• SonarDelphi专属排除参数
  部分sonar-delphi插件支持专属排除配置，而非通用的sonar.exclusions，可以尝试添加：

  sonar.delphi.exclusions=file1.pas,file2.pas,file3.pas
  

• 命令行参数格式修正
  你之前用的-D"sonar.exclusions"格式存在问题，Windows命令行下正确写法为：

  sonar-scanner.bat -Dsonar.exclusions=file1.pas,file2.pas,file3.pas
  

  无需给参数名加引号，直接赋值即可避免解析失败。

• 清理分析缓存
  SonarScanner可能缓存旧的分析结果，导致新的排除配置不生效：

  • 删除项目根目录下的.scannerwork文件夹
  • 登录SonarQube服务器，找到对应项目点击「重新分析」强制刷新数据

• 检查服务器端配置冲突
  SonarQube网页端项目设置里的排除规则会覆盖本地配置，进入项目「设置」→「分析范围」→「排除文件」，确认没有冲突的规则。

验证配置有效性 #

执行SonarScanner时添加-X参数开启调试模式，查看日志中是否有类似以下输出，确认排除文件被正确识别：

Excluded sources: file1.pas, file2.pas, file3.pas

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