Sublime Text中集成SonarQube本地代码扫描-sublime-PHP中文网

sublime text 无法直接运行 sonarqube 扫描，因其无内置分析引擎和 http 客户端能力，仅可通过构建系统调用本地 sonar-scanner cli 实现简易集成，或使用社区版 sonarlint 插件进行离线轻量检查。

sublime text中集成sonarqube本地代码扫描

Sublime Text 本身不支持直接运行 SonarQube 扫描，它没有内置的分析引擎，也不能直接调用 sonar-scanner 或连接 SonarQube Server。所谓“集成”，实际是借助构建系统（Build System）调用外部 CLI 工具，把扫描结果输出到 Sublime 的面板里——本质是本地命令行的可视化封装，不是真正意义上的服务端联动。

为什么不能直接连 SonarQube Server？

SonarQube 的设计模型要求：扫描必须由客户端（如 sonar-scanner、Maven 插件、Gradle 插件）执行源码分析，再将结果 POST 到 Server 的 API。Sublime 没有 HTTP 客户端能力去构造完整扫描请求（含 token、projectKey、sources、report 等参数），也不处理二进制分析器（如 Java 的 sonar-java、JS 的 sonar-javascript）依赖。

sonar-scanner 需要完整项目结构（sonar-project.properties 或 CLI 参数）、JDK/Node.js 环境、以及能访问 SonarQube Server 的网络权限
Sublime 的 Build System 只能执行简单命令，无法动态生成分析报告、上传结果或解析 server 返回的 JSON 结构化数据
即使你用 curl 手动发请求，也绕不开扫描阶段缺失——Server 不会自己去 Git 仓库拉代码分析

可行方案：用 Sublime 调用本地 sonar-scanner CLI

前提是你的机器已安装并配置好 sonar-scanner，且项目根目录下有 sonar-project.properties。Sublime 只负责触发命令、捕获 stdout/stderr 并展示。

Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载

在 Sublime 中新建 Build System：Tools → Build System → New Build System

填入以下内容（路径需按实际调整）：

{
  "cmd": ["sonar-scanner", "-X"],
  "path": "/usr/local/bin:/opt/sonar-scanner/bin",
  "working_dir": "$project_path",
  "selector": "source.java",
  "quiet": false,
  "encoding": "utf-8"
}

-X 开启 debug 日志，方便排查连接失败、token 错误、sonar.host.url 不可达等问题
保存为 SonarScanner.sublime-build，然后按 Ctrl+B（Windows/Linux）或 Cmd+B（macOS）运行
注意：sonar-scanner 默认不输出问题列表到控制台，只打印日志；真正的问题需登录 SonarQube Web 页面查看

更实用的替代：用 SonarLint 插件做轻量级本地检查

如果你只是想在写代码时快速看到潜在 bug 或安全热点（比如空指针、硬编码密码、XSS 风险），SonarLint 是 Sublime 的合理选择——它离线运行规则引擎，不依赖 Server。

通过 Package Control 安装 SonarLint 插件（注意：官方仅正式支持 VS Code 和 IntelliJ，Sublime 版本由社区维护，功能有限）
插件依赖 Python 环境，需手动指定 sonarlint.jar 路径（通常从 sonarlint.org 下载）
它只运行部分规则（如 Java 的 S1192 字符串字面量重复、JS 的 S5783 不安全的 innerHTML 使用），不支持自定义规则集或覆盖率分析
和 sonar-scanner 无共享配置：你在 sonar-project.properties 里关掉的规则，SonarLint 不会同步关闭

真正要落地增量扫描、分支比对、质量门禁或团队统一规则，必须走 CI 流程（Jenkins/GitLab CI）调用 sonar-scanner。Sublime 最多是个快捷触发入口，别指望它替代 IDE 的深度集成或 CI 的可靠性。容易被忽略的是：本地扫描若没配 sonar.branch.name 和 sonar.pullrequest.key，Server 根本识别不出这是“增量”，默认还是全量索引。这点在 Sublime 触发时几乎没人手动传参，结果就是白扫。