SonarLint不标红主因是未启用或语言模式不匹配，需检查sonarlint.enabled设置、右下角语言标识并切换为对应语言；规则修改后必须重载窗口才生效；连SonarQube才能同步团队规则与质量门禁。
装完 SonarLint 插件没波浪线、不标红，不是插件坏了，而是它默认处于“休眠状态”——sonarlint.enabled 多数为 false，且语言模式不匹配时直接静默失效。
检查 sonarlint.enabled 和右下角语言模式
这是 90% 无反应问题的根源。VSCode 不会自动为所有文件启用 SonarLint，尤其对新项目、自定义后缀或未识别语法的文件。
- 按
Ctrl+,（Windows/Linux）或Cmd+,（macOS）打开设置，搜索sonarlint.enabled，确保勾选； - 看编辑器右下角状态栏显示的语言名——如果是
Plain Text或JSON，点击它，手动切换成JavaScript、TypeScript、Python等真实语言； - 检查项目根目录下的
.vscode/settings.json，删掉类似"sonarlint.enabled": false这种全局禁用项； -
.ts文件失效还可能是 TypeScript 语言服务器被禁用，去扩展列表确认官方TypeScript扩展已启用。
规则修改后必须重载窗口才生效
改了 sonarlint.rules 配置却不生效？热更新不触发规则重载，这是高频误操作点。
- 在问题提示上点灯泡图标 → “Configure rule”，复制规则 ID（如
typescript:S3776）； - 在用户设置或工作区设置中添加：
"sonarlint.rules": {"typescript:S3776": {"level": "warn"}}； - 级别只能填
off、warn、error，填info会被忽略； - 改完必须执行
Ctrl+Shift+P→ 输入Developer: Reload Window，否则配置不加载。
连不上 SonarQube 就等于没进团队质量门禁
本地默认用的是开源 SonarWay 规则集，和 CI 流水线里实际跑的规则、阈值、质量门禁完全脱钩。不连服务器，PR 被打回时你才会知道漏了什么。
- 命令面板输
SonarLint: Configure Connected Mode→Add new server； -
serverUrl填公司 SonarQube 地址（如https://sonar.your-company.com），别漏https://； - 认证用 Token：去 SonarQube 网页端
User > My Account > Security > Generate Tokens； - 绑定项目时，“Project Key”不是项目名，是形如
org:my-backend-service的标识符，填错一个字符，后续所有规则同步都静默失败。
不同语言分析能力天然不均等——Java 能做数据流分析，Python 默认只走 AST；JS/TS 若用了自定义 eslint 配置，得显式开 "sonarlint.rules.eslint.enabled": true；而 Python 想激活空指针类强规则，光装插件不够，还得连上 SonarQube 才能解锁。这些不是配置错了，是能力边界本身如此。
