当在 Gradle 多模块项目中使用自定义 Checkstyle 规则（如继承 AbstractCheck 的类）时，若根项目执行 Checkstyle 任务失败并提示“Unable to instantiate class”，根本原因在于 Checkstyle 的 ClassLoader 未正确加载自定义 Checker 所在模块的字节码——需显式将含 Checker 的子模块声明为 checkstyle 配置依赖。
当在 gradle 多模块项目中使用自定义 checkstyle 规则（如继承 `abstractcheck` 的类）时，若根项目执行 checkstyle 任务失败并提示“unable to instantiate class”，根本原因在于 checkstyle 的 classloader 未正确加载自定义 checker 所在模块的字节码——需显式将含 checker 的子模块声明为 `checkstyle` 配置依赖。
在多模块 Gradle 项目中，Checkstyle 插件默认仅从 checkstyle 依赖中加载检查器类（如 com.puppycrawl.tools.checkstyle.Checker），而不会自动扫描项目源码或子模块输出的 classpath。即使你的 CustomChecker 类已成功编译进 submodule-project-name-1.0-SNAPSHOT.jar，若该 JAR 未被正确注入到 Checkstyle 的运行时 ClassLoader，就会触发 Unable to instantiate 'com.company.CustomChecker' 错误。
关键问题在于你当前的配置：
dependencies {
checkstyle files('build/libs/submodule-project-name-1.0-SNAPSHOT.jar')
}
该写法存在两个隐患：
- files(...) 指向的是 尚未构建完成的 JAR（因为 checkstyle 任务通常早于 build 任务执行），导致路径无效或文件不存在；
- 即使路径有效，files() 不支持 Gradle 的模块依赖解析，无法保证正确的类路径顺序与依赖传递性。
✅ 正确做法是：将包含 CustomChecker 的子模块作为 checkstyle 配置的项目依赖（project dependency），让 Gradle 自动处理编译产出、classpath 和依赖传递：
// 在根项目的 build.gradle 或对应 submodule 的 build.gradle 中（推荐在根项目统一配置）
checkstyle {
toolVersion = "8.45.1" // 建议升级至较新稳定版（如 8.45+ 或 10.x），兼容性更好
configFile = rootProject.file("submodule-project-name/config/checkstyle/checkstyle.xml")
dependencies {
// ✅ 正确方式：声明子模块为 checkstyle 依赖
checkstyle project(':submodule-project-name')
// 可选：显式添加 Checkstyle 官方库（避免版本冲突）
checkstyle "com.puppycrawl.tools.checkstyle:checkstyle:8.45.1"
}
}
? 注意：project(':submodule-project-name') 必须与 settings.gradle 中定义的子模块名称完全一致（区分大小写），且该模块需已应用 Java 插件并成功编译出 classes 与 jar 产物。
同时，请确保 checkstyle.xml 中的模块引用格式正确（无需修改）：
<module name="com.company.CustomChecker"></module>
——只要类路径正确、类名拼写无误、且 CustomChecker 满足 Checkstyle 的 SPI 约束（public、无参构造、继承 AbstractCheck），即可被自动发现。
? 补充注意事项：
- 避免混合使用 files() 与 project() 依赖：二者 ClassLoader 加载机制不同，混用易引发冲突；
- 验证自定义类可见性：CustomChecker 必须是 public 类，且所在包 com.company 不能被 checkstyle 的模块隔离策略屏蔽（Gradle 6.0+ 默认启用 strict Java module 检查，但 Checkstyle 通常不受影响）；
- 调试技巧：可在 CustomChecker 构造函数中添加 System.out.println("CustomChecker loaded!")，配合 ./gradlew checkstyleMain --info 查看是否被加载；
-
升级建议：Checkstyle 8.11 较旧（发布于 2018 年），已知存在 ClassLoader 兼容性问题；强烈建议升级至 8.45.1 或 10.12.2（需同步更新 XML 配置语法，如
已弃用，应改用 + 的嵌套结构）。
通过将子模块声明为 checkstyle 依赖，Gradle 会自动将其 build/classes/java/main 和 build/libs/*.jar 注入 Checkstyle 的 ClassLoader，彻底解决类找不到问题，实现跨模块自定义规则的无缝复用。
