sublime text 官方不支持 sonarlint 插件，因其缺乏 lsp 客户端能力与 jvm 进程管理；替代方案是通过 sonar-scanner-cli + build system + sublimelinter 实现保存即扫与错误高亮。
为什么 Sublime Text 官方不支持 SonarLint 插件
SonarLint 的核心是 Java 后端分析引擎，依赖完整的 LSP（Language Server Protocol）客户端能力与 JVM 进程管理，而 Sublime Text 的插件生态基于 Python 且不内置 LSP 客户端（subl 自身无 stdio server 生命周期控制、workspace 初始化、notification 路由等机制）。官方从未发布 SonarLint for Sublime Text，所有声称“已集成”的教程实际都是误导或混淆了 sonar-scanner-cli 的手动调用。
替代方案：用 sonar-scanner-cli + Sublime Text 构建轻量本地扫描流
可行路径是绕过 LSP，改用命令行扫描器 sonar-scanner，配合 Sublime Text 的 build system 触发，再用 SublimeLinter 解析输出。关键不是“实时提示”，而是保存即扫、错误高亮。
- 必须提前下载并解压
sonar-scanner-cli（如sonar-scanner-4.8.0.2856-linux），配置好SONAR_SCANNER_HOME环境变量 - 项目根目录需存在
sonar-project.properties，至少包含：sonar.projectKey、sonar.sources=.、sonar.host.url=https://sonarcloud.io（或自建 SonarQube 地址） - Sublime Text 中新建 Build System（
Tools → Build System → New Build System），内容如下：
{
"cmd": ["$HOME/sonar-scanner/bin/sonar-scanner", "-Dsonar.login=${env:SONAR_TOKEN}", "-Dsonar.host.url=${env:SONAR_HOST_URL}"],
"working_dir": "${project_path}",
"selector": "source.java, source.js, source.py",
"variants": [
{
"name": "With Output Parse",
"cmd": ["$HOME/sonar-scanner/bin/sonar-scanner", "-Dsonar.login=${env:SONAR_TOKEN}", "-Dsonar.host.url=${env:SONAR_HOST_URL}", "-Dsonar.analysis.mode=preview", "-Dsonar.report.export.path=sonar-report.json"],
"shell": true
}
]
}
注意：-Dsonar.analysis.mode=preview 是关键，它跳过上传，只生成本地报告；sonar-report.json 可被后续解析工具消费。
如何让扫描结果在编辑器里直接标出问题行
Sublime Text 本身不解析 sonar-scanner 输出，但可借助 SublimeLinter + 自定义 linter 插件桥接。这不是开箱即用的配置，需要手动写一个极简解析器：
- 安装
SublimeLinter和SublimeLinter-contrib-slc（社区维护的 SonarLint CLI 封装器，非官方） - 该插件本质是监听
sonar-report.json文件变化，用正则提取"line": 42、"message": "Remove this unused ..."等字段 - 必须确保
sonar-scanner执行后立即生成sonar-report.json，且路径与插件中report_path配置一致（默认为${project_path}/sonar-report.json） - 不支持跨文件跳转，仅当前打开文件中的问题能高亮；若问题在未打开的
utils.py里，不会显示
常见失败原因和绕不过去的限制
很多人卡在“build 成功但没报错也没高亮”，根本原因往往不是配置错，而是语义层缺失：
-
sonar-scanner默认不分析未提交 Git 的新文件——加参数-Dsonar.scm.disabled=true强制扫描所有源码 - Java 项目必须提供
sonar.java.binaries指向target/classes或build/classes，否则空分析 - JavaScript/TypeScript 项目需额外配
sonar.javascript.lcov.reportPaths或启用tsconfig.json，否则语法树构建失败，静默跳过 - Sublime Text 的 build system 不支持异步等待，
sonar-scanner耗时 >10s 时，Sublime 可能直接中断进程，需在终端先验证单次扫描是否稳定完成
真正难的从来不是怎么把命令塞进 build system，而是让 sonar-scanner 在没有完整 IDE 上下文（如 classpath、tsconfig resolve、webpack alias）的情况下，依然能正确解析引用和类型——这点 Sublime Text 做不了，SonarLint 官方也不打算支持。
