Checkstyle插件不生效主因是模块未绑定、实时扫描未启用或版本不匹配；需确认Java语言级别、用绝对路径、重载配置、降级至8.36适配P3C，并统一各组件版本。
IntelliJ IDEA 里装 Checkstyle 插件后不生效？
插件装了，配置也导入了，但代码没标红、检查不触发——大概率是没绑定到当前模块或没启用实时扫描。
- 必须在
Settings > Editor > Code Style > Java里确认语言级别匹配（比如项目用 Java 17，Checkstyle 规则文件里不能写javaVersion="8"） - Checkstyle 配置文件（如
checkstyle.xml）路径要填绝对路径，相对路径在多模块项目里极易失效 - 右键单个文件时选
Check Current File是最可靠的验证方式；仅靠编辑器底部状态栏的“Checkstyle”开关不等于实时检查已开启 - 如果用了 Maven 多模块，每个子模块需单独在
Settings > Tools > Checkstyle中勾选 “Scan scope” 里的对应模块
P3C 插件和 Checkstyle 冲突导致报错？
两者都基于 Checkstyle 引擎，但 P3C 自带规则集与部分 Checkstyle 版本不兼容，常见报错是 Cannot initialize module TreeWalker 或 NoClassDefFoundError: com/puppycrawl/tools/checkstyle/api/TreeWalker。
- P3C 插件只支持 Checkstyle 6.18–8.36，高于 8.36（比如 9.x）会直接崩溃；IDEA 自带的 Checkstyle 版本常是 10.x，得手动降级
- 解决方法：下载
checkstyle-8.36-all.jar，在Settings > Tools > Checkstyle > Configuration File下方点击“+”添加该 jar，并设为 active - 不要同时启用 P3C 和自定义 Checkstyle 规则——P3C 本质就是一套预置 Checkstyle 配置，重复加载会抢资源
为什么改了规则文件，IDEA 里还是不提示？
Checkstyle 规则变更不会自动热重载，尤其涉及模块级配置或父 POM 继承时，缓存行为更隐蔽。
- 每次修改
checkstyle.xml后，必须点Settings > Tools > Checkstyle > Configuration File右侧的Reload按钮 - 如果项目用 Maven，且
maven-checkstyle-plugin的版本和 IDEA 插件不一致（比如 Maven 用 3.3.0，IDEA 用 8.36），规则解释可能不同，建议统一用 3.2.0 + Checkstyle 8.36 - IDEA 的缓存有时会卡住：可尝试
File > Invalidate Caches and Restart… > Just Restart，别跳过重启
检查结果里一堆 Missing a Javadoc comment 怎么关掉？
这是 Checkstyle 默认规则 JavadocMethod 在起作用，不是 bug，但团队若不强制文档注释就得关。
- 打开你的
checkstyle.xml，找到<module name="JavadocMethod"></module>这一行，整段注释掉或删掉 - 如果用的是 P3C 的
p3c-pmd.xml，它默认不开这个，但有些团队二次修改时加了，得搜Javadoc关键词定位 - 注意：关规则只是屏蔽提示，不影响编译或 CI；CI 环境里是否关闭，得看
maven-checkstyle-plugin的configuration是否同步更新
version 属性和真实加载的引擎版本不匹配——它不报错，只当没这规则。 
