SonarLint在VSCode中需手动配置才能正常工作：启用插件、切换正确语言模式、配置语言服务器和规则集，连接SonarQube实现团队规则同步。
SonarLint在 VSCode 里不是装完就“自动全开”的工具——它默认只对部分语言启用、规则强度不均、很多问题根本不会标红，除非你调对了几个关键开关。
插件装了但没波浪线？先确认 sonarlint.enabled 和语言模式
这是最常见卡点：插件已安装，但打开 .py 或 .ts 文件完全没反应。
- 按
Ctrl+,（Windows/Linux）或Cmd+,（macOS）打开设置，搜sonarlint.enabled，确保勾选； - 看右下角状态栏——如果显示的是
Plain Text或JSON，点击它，手动切换成对应语言（如Python、TypeScript）； - 检查项目根目录的
.vscode/settings.json，别有"sonarlint.enabled": false这种全局禁用项； -
.ts文件失效还可能是 TypeScript 语言服务器被禁用，去扩展列表搜TypeScript，确保官方扩展启用。
Java/JS/Python 规则表现差异大，别怪插件“漏报”
不是所有语言都能做深度分析：SonarLint 对 Java 支持数据流分析（比如能标出 list.get(0) 可能抛 IndexOutOfBoundsException），而 Python 默认只做 AST 检查，my_list[0] 就不会预警——这不是 bug，是能力边界。
- Java 项目想让泛型、资源泄漏类警告生效，得在设置里配
"sonar.java.binaries": "target/classes"； - JS/TS 若用了自定义
eslint配置，必须显式开启"sonarlint.rules.eslint.enabled": true，否则只跑 Sonar 自带弱规则； - Python 想启用空指针、未关闭文件等强规则，光装
SonarLint不够，还得额外装sonar-python插件，且仅在连接 SonarQube 后才激活。
规则太多太吵？别关插件，精准关单条规则
直接设 "sonarlint.enabled": false 是懒办法，真正要的是控制粒度。
- 在问题提示上点灯泡 → “Configure rule”，能看到规则 ID（如
javascript:S1192表示字符串重复）； - 在用户或工作区设置中加
"sonarlint.rules"对象，例如："sonarlint.rules": { "javascript:S1192": { "level": "off" }, "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），connectionId自定义但要记牢； - 认证用 Token（去 SonarQube 网页端
User > My Account > Security > Generate Tokens）； - 绑定项目时，“Project Key”不是项目名，是配置里那个带
org:project格式的唯一标识，错一个字符就同步失败。
真正容易被忽略的是：语言服务器是否就位、connectedMode 的 connectionId 是否和项目绑定时一致、以及 Python/JS 等语言依赖外部引擎（sonar-python / ESLint）是否已装且路径可访问——这些环节任一断掉，都会让分析静默失效，而不是报错提醒。
