添加自定义Lint规则遇同步错误：lintChecks多Jar包，如何排查？

云原生阿岚

2026-5-6

排查lintChecks配置中多Jar包问题的方法

我来给你梳理几个实用的排查步骤，帮你快速定位问题根源：

直接查看lintChecks配置的完整依赖树
运行Gradle命令来列出app模块下lintChecks配置的所有依赖（包括传递依赖）：
```
# macOS/Linux
./gradlew app:dependencies --configuration lintChecks

# Windows
gradlew.bat app:dependencies --configuration lintChecks
```
这个命令会输出所有关联到lintChecks的依赖项，你可以仔细查看输出，找有没有重复的Jar包，或者意外引入的第三方lint规则Jar。
过滤依赖输出，缩小排查范围
如果上面的输出太冗长，可以用过滤命令快速定位Jar相关的条目：
```
# macOS/Linux
./gradlew app:dependencies --configuration lintChecks | grep -A 3 -B 3 "jar"

# Windows
gradlew.bat app:dependencies --configuration lintChecks | findstr /C:"jar"
```
这样能更清晰地看到哪些依赖最终生成或引入了Jar包。
检查模块的依赖声明
逐一检查项目中所有模块的build.gradle文件：
- 确认你的自定义Lint模块是否用compileOnly而非implementation引入依赖（比如Android Lint API），避免将依赖的Jar也打包进最终的Lint Jar。
- 检查主模块或其他模块的lintChecks配置，有没有同时添加了多个Lint Jar依赖（比如既加了自定义模块，又加了第三方Lint库）。
用依赖洞察命令精准定位
如果已经怀疑某个库或模块是问题源头，用dependencyInsight命令查看它的引入路径：
```
./gradlew app:dependencyInsight --dependency <可疑库/模块名称> --configuration lintChecks
```
这个命令会告诉你该依赖是被哪个父依赖引入的，帮你快速锁定问题所在。