sonarlint不标红主因是sonarlint.enabled为false或语言模式不匹配；需检查启用状态、切换正确语言、删除禁用配置、重载窗口生效规则；连接sonarqube才能同步团队规则，且各语言分析能力存在天然差异。
装完 SonarLint 插件不标红、没波浪线，不是插件坏了，而是默认配置没打开关键开关——sonarlint.enabled 多数情况下是 false，且语言模式不匹配时直接静默失效。
插件装了但编辑器里完全没反应？先查 sonarlint.enabled 和语言模式
这是最常卡住的一步。VSCode 安装插件后不会自动启用所有功能，尤其对新项目或非标准文件后缀。
- 按
Cmd+,（macOS）或Ctrl+,（Windows/Linux）打开设置，搜sonarlint.enabled，确保勾选； - 看右下角状态栏显示的语言名——如果是
Plain Text或JSON，点击它手动切换成JavaScript、TypeScript、Python等对应语言； - 检查项目根目录下的
.vscode/settings.json，删掉类似"sonarlint.enabled": false这种全局禁用项； -
.ts文件失效还可能是 TypeScript 语言服务器被禁用，去扩展列表确认官方TypeScript扩展已启用。
sonarlint.rules 配置必须重载窗口才生效
想关掉某条烦人的规则（比如 javascript:S1192 字符串重复警告），不能只改 settings.json 就完事——改完不重载，等于没改。
- 在问题提示上点灯泡图标 → “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/JS/Python 规则强度差异大，别拿 Python 当 Java 用
这不是配置问题，是分析引擎能力边界。SonarLint 对不同语言的实时分析深度天然不均等。
- Java 支持局部数据流分析，
list.get(0)会立刻标红“可能抛IndexOutOfBoundsException”； - JavaScript 依赖 ESLint 引擎补位，需在
settings.json显式设"sonarlint.rules.eslint.enabled": true； - Python 默认只做 AST 检查，
my_list[0]不会预警空指针——想增强得额外装sonar-python插件，且仅在连接 SonarQube 后才激活； - Java 项目若没配
sonar.java.binaries指向target/classes，泛型擦除相关警告会漏掉。
真正麻烦的不是怎么连上，而是连上之后发现规则 ID 在不同 SonarQube 版本间有微小变动，或者团队自定义规则用了私有插件——这些都不会出现在本地规则列表里，得靠服务器同步才能看到，但同步失败时没有任何错误提示，只表现为“该报的没报”。
