Checkstyle最小可运行配置需以Checker为根、TreeWalker为父容器嵌套MethodLength模块，并设max=20、tokens=METHOD_DEF、ignoreOverriddenMethods=true。
Checkstyle 的 XML 配置文件通过 `
明确你要定制的规则类型
Checkstyle 规则分三类，配置方式略有不同：
-
内置规则（如 JavadocMethod、EmptyBlock）：直接启用 + 调整属性（
property）即可，比如关闭某个检查项或修改提示级别 -
规则组合（如 TreeWalker 下挂多个检查）：XML 中靠父子嵌套实现，例如把
MethodLength放在TreeWalker内才生效 -
自定义规则（需 Java 类）：XML 中用
<module name="MyCustomCheck"></module>引用，但必须把编译好的 class 或 jar 加入 Checkstyle classpath
写一个最小可运行的自定义配置示例
比如只检查方法长度不超过 20 行，且忽略 getter/setter：
<?xml version="1.0"?>
<!DOCTYPE module PUBLIC
"-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
"https://checkstyle.org/dtds/configuration_1_3.dtd">
<module name="Checker">
<module name="TreeWalker">
<module name="MethodLength">
<property name="max" value="20"/>
<property name="tokens" value="METHOD_DEF"/>
<property name="ignoreOverriddenMethods" value="true"/>
</module>
</module>
</module>
注意：Checker 是根模块，TreeWalker 是绝大多数代码检查规则的父容器，没它，MethodLength 不会触发。
常用自定义技巧
-
禁用某条规则：删掉对应
<module name="xxx"></module>，或加<property name="severity" value="ignore"></property> -
调整警告级别：在任意规则下加
<property name="severity" value="warning"></property>（可选error/warning/info） -
按文件路径过滤：在
Checker下加<property name="fileExtensions" value="java"></property>，或用SuppressionFilter配合 suppressions.xml -
复用配置片段：用 XInclude（需开启
-xinclude参数）拆分 common-rules.xml 和 project-specific.xml
验证配置是否生效
别靠猜，执行一次检查最可靠：
- 命令行运行：
java -jar checkstyle-x.x.jar -c my-checks.xml src/MyClass.java - 看输出是否有预期违规（比如 “Method length is 25”），没有就说明规则没加载或条件不匹配
- 常见失败原因：DTD 地址拼错、module name 大小写不对（如
methodlength❌，必须MethodLength✅）、缺少必要父模块
基本上就这些。XML 结构看着多，实际改几处 property 就能适配团队规范，不复杂但容易忽略嵌套关系。
