Sublime Text 无法原生集成 sonar-scanner，仅能通过自定义构建系统调用 CLI 执行扫描并输出日志，不支持问题行跳转、实时提示、内联标记或结果高亮；扫描结果需在 SonarQube Web UI（如 https://www.php.cn/link/b99c61acedb54c5253819b7b4f2d88c6/dashboard?id=xxx）查看，Sublime 仅作触发与编辑闭环。
sonar-scanner 不能直接在 Sublime Text 中运行 —— 它没有内置的插件机制来调用外部 CLI 工具并解析 JSON/HTML 报告，也没有原生支持 sonar-scanner 的项目配置绑定、token 管理或结果高亮。所谓“Sublime Text 集成 SonarScanner”，本质是绕过 IDE 插件依赖，用轻量级命令行 + 文件监听 + 自定义构建系统实现本地快速扫描。
sonar-scanner 在 Sublime Text 中能做什么、不能做什么
- ✅ 能：通过 Sublime 的
Tools > Build System > New Build System定义一个调用sonar-scanner的命令，执行全量扫描并输出日志到 Sublime 控制台 - ❌ 不能：自动跳转到问题行、实时悬停提示、内联标记违规代码、同步刷新 Web UI 或加载
sonarqube的质量门禁结果 - ⚠️ 注意：Sublime 不管理项目语言上下文（如 Java 的
pom.xml或 Python 的setup.py），所有路径、语言参数、源码根目录都得手动写死或靠变量推导，极易出错
常见错误现象包括：
-
ERROR: Unable to execute SonarQube analysis: java.lang.IllegalStateException: Fail to request <a href="https://www.php.cn/link/467ef93e6176e6804e902a897b006023">https://www.php.cn/link/467ef93e6176e6804e902a897b006023</a>（服务未启或 URL 错） -
ERROR: Not authorized. Please check the 'sonar.login' property.（token 未配或过期） -
ERROR: The project key is not provided（-Dsonar.projectKey=缺失） - 扫描完成但 Web 页面无数据 → 实际是
sonar-scanner成功但未匹配到服务端已注册的 project key
如何配置 Sublime Build System 调用 sonar-scanner
前提：确保已安装 sonar-scanner 并加入 $PATH，且 sonarqube 服务正常运行（如 <a href="https://www.php.cn/link/b99c61acedb54c5253819b7b4f2d88c6">https://www.php.cn/link/b99c61acedb54c5253819b7b4f2d88c6</a> 可访问）
- 打开 Sublime Text →
Tools > Build System > New Build System - 替换默认内容为以下 JSON（以 Java 项目为例，路径和参数需按实际调整）：
{
"cmd": ["sonar-scanner",
"-Dsonar.projectKey=my-java-app",
"-Dsonar.sources=.",
"-Dsonar.host.url=https://www.php.cn/link/b99c61acedb54c5253819b7b4f2d88c6",
"-Dsonar.login=63a8b5e9f1c2d4a7b8c9e0f1a2b3c4d5"],
"working_dir": "${project_path}",
"selector": "source.java",
"encoding": "UTF-8",
"shell": true
}
- 保存为
SonarScanner.sublime-build（自动存入Packages/User/） - 在项目根目录下确保存在
sonar-project.properties（推荐方式，比命令行参数更稳定）：
sonar.projectKey=my-java-app sonar.projectName=My Java App sonar.projectVersion=1.0 sonar.sources=src/main/java sonar.language=java sonar.host.url=https://www.php.cn/link/b99c61acedb54c5253819b7b4f2d88c6 sonar.login=63a8b5e9f1c2d4a7b8c9e0f1a2b3c4d5
⚠️ 关键点：如果同时用了命令行参数和
sonar-project.properties，后者优先级更高；但若sonar-project.properties存在而sonar.login写错，Sublime 构建会静默失败（无报错提示，只显示“[Finished]”）
sonar-scanner 扫描结果怎么在 Sublime 里“看”？
Sublime 不解析 sonar-scanner 输出的 JSON 报告，它只显示终端日志。真正有用的信息藏在服务端：
- 扫描成功后，打开
<a href="https://www.php.cn/link/b99c61acedb54c5253819b7b4f2d88c6/dashboard?id=my-java-app">https://www.php.cn/link/b99c61acedb54c5253819b7b4f2d88c6/dashboard?id=my-java-app</a>查看完整问题列表、规则命中、覆盖率、重复率等 - 若想快速定位某类问题（如 “Null pointer dereference”），需在 SonarQube Web UI 中用搜索框或规则 ID（如
java:S2259）过滤，再手动跳转到对应文件行号 - Sublime 本身无法反向链接 —— 没有插件能读取
sonarqubeAPI 返回的 issue list 并映射到当前编辑器视图
所以，“本地深度自检”的真实路径是：
- 用 Sublime 触发
sonar-scanner - 切到浏览器看结果
- 回 Sublime 修改代码
- 再构建 → 再刷新页面 → 循环
容易被忽略的兼容性陷阱
-
sonar-scanner10.x 要求 JDK 17+，但 Sublime 启动时继承的是系统默认 JDK（可能仍是 JDK 8）→ 运行时报Unsupported class file major version
→ 解决：在sonar-scanner的bin/sonar-scanner脚本开头硬编码JAVA_HOME=/path/to/jdk-17 - Windows 下路径含空格（如
C:\Program Files...）会导致sonar-scanner解析失败 → 改用短路径（C:\Progra~1...）或重装到无空格路径 - Sublime 的
working_dir变量在多窗口/多项目时行为不稳定，建议始终用${project_path}而非${file_path}，否则sonar-project.properties找不到 -
sonar-scanner默认不扫描测试代码，若需检查src/test/，必须显式加-Dsonar.tests=src/test/java和-Dsonar.test.inclusions=*<em>/</em>.java
真正卡住人的，往往不是配置步骤，而是误以为 Sublime 能像 Eclipse 那样“一键跳转问题”。它不能。它只是个启动器。
