checkstyle插件在idea不生效需三步：一配pom.xml中checkstyle-maven-plugin并绑定validate阶段；二在idea设置中手动指定实际checkstyle.jar路径及checkstyle.xml绝对路径；三删除配置中已废弃的treewalker模块，将子规则移至checker下且注意大小写。
Checkstyle插件在IDEA里不生效？先确认Maven依赖和插件绑定
IDEA自带的Checkstyle插件只是个“壳”，它本身不带规则引擎，也不自动读取项目里的配置。真正起作用的是项目中声明的 checkstyle-maven-plugin 或 Gradle 的 checkstyle 插件。如果只装了IDEA插件但没配Maven，编辑器里标红、保存时检查全都不会触发。
- 确保
pom.xml中有checkstyle-maven-plugin，且<phase>validate</phase>绑定到构建生命周期（否则mvn compile不会跑检查） - IDEA插件设置里必须手动指定
checkstyle.jar路径——不能用插件自带的默认版本，要指向你项目target/checkstyle/下或 Maven 本地仓库里实际加载的那个版本，否则规则解析失败 - 规则文件（如
checkstyle.xml）路径要在IDEA插件设置里填绝对路径或相对于项目根目录的路径，填错会导致“no checks configured”警告
自定义规则文件里 TreeWalker 报错？别直接复制老版本配置
Checkstyle 8.0+ 彻底移除了 TreeWalker 模块，所有检查器现在直属于 Checker。如果你从网上抄的配置还写着 <module name="TreeWalker"></module>，Maven 构建时会直接报 Cannot set property 'name' to 'TreeWalker'，IDEA 插件也会灰掉不加载。
- 删掉所有
<module name="TreeWalker"></module>和对应的闭合标签，把里面的子<module></module>（比如EmptyBlock、LineLength）全部提到顶层<module name="Checker"></module>下 - 注意模块名大小写：新版本要求
Indentation，不是indentation；MethodLength不是methodlength - 如果用了第三方规则集（如 Google 或 Alibaba 规范），务必核对其适配的 Checkstyle 版本号，
checkstyle-8.42和checkstyle-10.12.0的 XML 结构不兼容
Maven执行 mvn checkstyle:check 失败，但IDEA里却显示正常？检查执行上下文差异
IDEA 插件默认只检查打开的文件，且使用的是当前 module 的 classpath 和配置；而 mvn checkstyle:check 是命令行全量扫描，走的是 src/main/java + src/test/java，且严格校验 suppressions.xml 路径是否存在、是否可读。
- 常见错误：suppress 文件路径写成相对路径
./suppressions.xml，Maven 执行时工作目录是模块根目录，而 IDEA 可能从 project root 启动，导致 suppress 失效，误报一堆本该忽略的问题 -
checkstyle:check默认跳过 test 目录，若想检查测试代码，需显式配置<includetestsourcedirectory>true</includetestsourcedirectory> - 如果项目有多个 module，父 pom 的
checkstyle-maven-plugin配置不会自动继承到子 module，每个子 module 的pom.xml得单独声明或用pluginManagement统一管理
中文注释被 InvalidJavadoc 报错？Javadoc 检查器本质不支持非 ASCII
Checkstyle 的 JavadocMethod、JavadocType 等检查器底层依赖 Java 原生 Javadoc 解析器，它默认只接受符合 Javadoc 规范的英文结构（如 @param、@return），对中文描述、非标准标签、甚至中文标点都可能抛 Unable to get class information 或直接跳过验证——结果就是该报的没报，不该报的乱报。
立即学习“Java免费学习笔记（深入）”；
- 最稳妥做法：关掉所有 Javadoc 类检查器，改用
WriteTag或自定义正则检查注释存在性（例如强制每方法有// TODO或// @author） - 如果必须保留，把
allowMissingParamTags、allowMissingReturnTag全设为true，并禁用validateThrows，否则中文异常名（如业务异常）会触发解析失败 - 不要指望
charset参数能解决——Checkstyle 读取源码时用的是平台默认编码，Windows 上常为 GBK，而 Maven 默认用 UTF-8，这会导致注释内容乱码，进而让检查器误判语法错误
