SonarLint装完无反应，主因是分析引擎未启动：需启用sonarlint.enabled、确认文件语言模式正确、确保底层语言服务就位（如TS需tsconfig.json），且规则配置须严格遵循大小写与层级要求。
装完 SonarLint 插件却没波浪线、不报错、右下角图标灰着——这不是插件坏了，是它根本没启动分析引擎。默认状态下，SonarLint 在 VSCode 里多数时候处于“待机”状态，必须手动打开几个关键开关才能干活。
为什么 SonarLint 装了但完全没反应？
最常见原因就三个：插件被全局禁用、当前文件语言模式不对、底层语言服务器没就位。
-
sonarlint.enabled必须为true—— 按Ctrl+,搜这个配置项，勾选它； - 右下角状态栏显示的是
Plain Text或JSON？点它，手动切到JavaScript、TypeScript、Python等受支持语言； - .ts 文件失效，大概率是 VSCode 内置的
TypeScript扩展被禁用了；.java 文件没反应，检查java -version是否 ≥11；.py 文件无提示，确认已安装官方Python扩展（不是 Pylance 单独启用就行）； - 项目根目录的
.vscode/settings.json里别有"sonarlint.enabled": false这种硬性关闭项。
typescript:S6541 这类规则为啥不触发？
SonarLint 对 TypeScript 的语义级规则（比如禁止 any、未使用变量）依赖 TypeScript 语言服务提供类型信息。光有语法高亮不够，得让 TS 服务真正跑起来。
- 确保项目里有
tsconfig.json，且至少包含"compilerOptions": { "lib": ["es2020"] }这类基础配置； - 安装必要类型包，比如
@types/node，否则 TS 服务可能因解析失败而静默退出； - 在
settings.json中显式启用规则："sonarlint.rules": { "typescript:S6541": {"level":"error"} }； - 改完设置后必须执行
Ctrl+Shift+P→Developer: Reload Window，热更新不生效。
本地扫描和 SonarQube 网页端结果差很多，正常吗？
完全正常。VSCode 里的 SonarLint 默认只运行约 200 条轻量规则，不做跨文件数据流分析，也不读取 sonar-project.properties。
- Java 项目中
list.get(0)报错，是因为本地启用了数据流分析；但 Python 的my_list[0]不报，是因为 Python 默认只做 AST 检查，没连服务器就压根不启用空指针类规则； - JS/TS 若用了自定义 ESLint 配置，得手动开
"sonarlint.rules.eslint.enabled": true，否则只跑 Sonar 自带的弱规则； - 想让本地和 CI 一致？必须配
sonarlint.connectedMode.servers并绑定项目，否则你修复的“问题”，在流水线里照样被门禁打回。
怎么精准关掉某条烦人的规则，比如 javascript:S1192？
直接关插件是懒办法。SonarLint 支持按规则 ID 控制粒度，但配置方式容易踩坑。
- 在编辑器里点问题旁的灯泡图标 →
Configure rule，就能看到完整规则 ID（如javascript:S1192）； - 在用户或工作区
settings.json中加"sonarlint.rules"块，写法严格："javascript:S1192": {"level":"off"}； -
level只接受off、warn、error，填info或disabled会整个规则块失效； - 改完不重载窗口，等于白改 ——
Developer: Reload Window是强制动作，不是可选项。
最容易被忽略的一点：规则 ID 大小写敏感，typescript 不能写成 TypeScript；sonarlint.rules 必须是顶层字段，嵌套在其他对象里（比如塞进 editor 下）就无效。连对服务器后，部分规则还会动态加载，本地配置只是起点，不是终点。
