必须配置 SonarLint 连接 SonarQube 服务器并绑定项目，否则本地规则与 CI 不一致；配置需严格遵循数组格式、serverUrl 无尾斜杠、token 字段名正确、connectionId 规范，且每个工作区须手动绑定项目 ID。
直接连上 SonarQube 服务器，本地规则才能和 CI 流水线保持一致——否则 SonarLint 默认只用内置的 SonarWay 规则集，你写的代码在 VSCode 里“绿油油”，提交后被 sonar-scanner 打回是常态。
sonarlint.connectedMode.connections.sonarqube 配置必须是数组且结构严格
VS Code 的 settings.json 里写错一个括号或引号，连接就静默失败，右下角图标也不亮。这不是插件没反应，而是配置根本没被加载。
-
sonarlint.connectedMode.connections.sonarqube字段值必须是数组，哪怕只配一个连接，也得包在[ ]里 -
serverUrl末尾不能带/（例如https://sonar.your-company.com/→ 404） -
token字段名不能写成authToken或userToken，否则认证被忽略 - 连接 ID（
connectionId）要简短、无空格、无特殊字符，比如"prod"或"dev"，后续绑定项目时要用到
每个工作区必须手动绑定到 SonarQube 上的真实项目 ID
光配好服务器不等于生效。VS Code 工作区（即打开的文件夹）默认不关联任何远程项目，仍走本地规则。不绑定，SonarLint 就不知道该查哪套规则、该报哪些技术债务。
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 快捷键
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux）→ 输入SonarLint: Bind to SonarQube Project - 选中刚配的
connectionId（如prod），等待项目列表加载完成（可能需几秒） - 从列表里选目标项目 —— 注意是项目
key（如my-node-api），不是中文显示名，也不是仓库名 - 成功后，状态栏右下角
SonarLint图标会显示连接状态 + 项目 ID；同时.vscode/settings.json里会自动生成sonarlint.defaultConnection字段
Node.js 项目里 sonar-project.properties 和 sonar-scanner 要对齐规则
本地 SonarLint 和 CI 中的 sonar-scanner 必须用同一套规则集，否则“本地过、流水线挂”问题反复出现。关键在于两者共用同一个 SonarQube 项目配置，而不是各自维护一套。
-
sonar-project.properties文件放在项目根目录，内容至少包含：sonar.projectKey=my-node-api（必须和 VS Code 绑定的项目 ID 一致）、sonar.sources=.、sonar.javascript.lcov.reportPaths=coverage/lcov.info（如有测试覆盖率） - 确保
sonar-scanner命令执行时使用的 token 和 VS Code 中配置的 token 权限一致（需含Execute Analysis） - Node.js 项目常用语言标识是
sonar.language=javascript，但实际可省略——sonar-scanner会自动识别.js、.ts文件 - 若项目含 TypeScript，建议加
sonar.typescript.tslint.configPath=tslint.json或启用 ESLint 集成，否则类型相关规则可能漏检
规则级别调优别关全局，优先用 sonarlint.rules 精控单条规则
Node.js 项目常因 console.log、no-unused-vars 或 JSDoc 强制要求产生大量误报，直接关掉 sonarlint.enabled 是掩耳盗铃——真正的问题是规则粒度太粗。
- 在工作区
.vscode/settings.json中添加sonarlint.rules对象，例如："javascript:S1192": {"level":"off"}（禁用字符串重复检查） - 规则 ID 可从问题提示里点灯泡图标 →
Configure rule查看，不同语言前缀不同（javascript:、typescript:、json:） - 级别只支持
"off"、"warn"、"error"，不支持"info"；改完必须重载窗口（Developer: Reload Window）才生效 - 避免在用户级设置里覆盖所有项目规则——按工作区单独配，防止影响其他项目的检查逻辑
最易被忽略的是：VS Code 启动时未继承 shell 的 PATH，导致 sonar-scanner 命令找不到，或者 node 版本与 SonarQube 分析器要求不匹配。务必确认终端里能直接运行 node -v 和 sonar-scanner -h，再调试集成问题。
