SonarLint在IDEA中需手动配置才能生效：默认仅启用少量规则，必须绑定SonarQube服务器、正确设置binaries路径、匹配Project Key、禁用自动库探测、适配JDK版本，并处理Lombok及规则冲突等问题。
IDEA里装SonarLint插件本身很简单，但默认配置几乎没用
装上就完事？不行。SonarLint在IDEA里默认只启用极少数规则（比如空指针警告），大部分Java关键规则（如资源未关闭、线程安全、安全漏洞模式）压根不触发——因为它们依赖项目级上下文，比如pom.xml里的依赖版本、JDK版本、甚至sonar-project.properties里定义的源码路径。
- 别点完“Install”就关窗口，装完必须进
Settings > Tools > SonarLint手动开启规则集 - 勾选
Enable SonarLint for this project只是开关，不等于规则生效；真正起作用的是右下角是否显示Connected to SonarQube或Bound to SonarCloud - 如果项目用Maven，务必确认
sonar.java.binaries指向正确的target/classes目录，否则类型推导失败，大量“未使用变量”“不可达代码”类规则会静默失效
绑定SonarQube服务器比用本地规则更实用
本地规则库（Offline mode）只有约120条Java规则，而连上公司自建SonarQube后，能实时同步全部600+条Java规则，包括定制规则和团队共用的质量门禁配置。
- 连接前先确认SonarQube服务端版本 ≥ 8.9（旧版不支持IDEA 2022.3+的gRPC协议）
- 在
Settings > Tools > SonarLint > Connected Mode里点+ Add Server Configuration，填Server URL和Token——Token必须是用户个人生成的，不能用管理员全局Token（权限不足会导致项目列表为空） - 绑定后右键项目→
SonarLint > Bind to SonarQube，此时弹窗里选中的Project Key必须和SonarQube网页端项目设置页显示的完全一致（区分大小写，含特殊字符），输错一个字符就同步失败且无明确报错
常见报错Failed to resolve dependencies for sonar.java.libraries怎么解
这个错误不是SonarLint坏了，是它找不到你项目编译后的jar包路径。尤其多模块Maven项目，子模块的target/classes可能被父模块的构建生命周期跳过，导致SonarLint扫描时路径为空。
- 打开
Settings > Tools > SonarLint > General，取消勾选Automatically configure libraries from Maven/Gradle（自动探测经常误判） - 手动在
Java > Libraries里添加路径：逐个添加每个模块的target/classes和target/test-classes（注意不是src/main/java） - 如果用JDK 17+，检查
sonar.java.source是否设为17（默认可能是11），否则Lambda表达式、sealed class等语法会被标成“语法错误”而非“代码异味”
为什么改了代码，SonarLint提示却不更新
不是缓存问题，是SonarLint默认只对“当前打开的文件”做实时分析，其他文件仅在保存时触发轻量扫描，且不重新计算跨文件调用链（比如A类调用B类方法，B类改了但A类没重开，A里的“过时API调用”警告不会消失）。
立即学习“Java免费学习笔记（深入）”；
- 强制全量重扫：右键项目根目录→
SonarLint > Analyze Project（注意不是“Analyze File”） - 想让修改立刻反映，把
Settings > Tools > SonarLint > General里的Run analysis on file save改成On every save（但会拖慢保存速度，尤其大项目） - 如果用了Lombok，必须额外安装
Lombok Plugin并勾选Enable annotation processing，否则@Data生成的getter/setter无法被SonarLint识别，所有“未使用方法”警告都是错的
最麻烦的其实是规则冲突：比如团队SonarQube开了 squid:S1192（字符串字面量重复），但本地又启用了java:S1192（SonarLint旧规则ID），两者规则逻辑不同却共存，结果同个字符串报两次。得去Settings > Editor > Inspections里手动关掉其中一个。
