./gradlew lint 默认检查所有 build variant 并生成 HTML/XML 报告,不中断构建;lintDebug 侧重快速反馈、跳过耗时检查,lintRelease 在 checkReleaseBuilds=true 时启用额外检查;abortOnError 需确保 lint 任务实际执行,否则不生效;HTML 报告应通过命令行指定路径并用 open/start 命令打开,baseline 更新后须重新运行 lint 才生效。

直接运行 ./gradlew lint 就能触发检查
默认会检查所有 build variant(比如 debug、release),生成 HTML 和 XML 报告,路径在 app/build/reports/lint-results.html。不加任何参数时,它只报告问题,不会中断构建——哪怕发现 Fatal 级别问题也照常编译通过。
lintDebug 和 lintRelease 的区别在哪
Android Gradle 插件为每个 variant 自动生成了独立的 lint 任务,比如 lintDebug、lintRelease。它们的区别主要在两处:
-
checkReleaseBuilds true配置下,lintRelease会额外启用一批仅对 release 生效的检查(如 ProGuard 相关规则) -
lintDebug默认跳过部分耗时检查(例如资源冗余分析),速度更快,适合日常开发快速反馈 - 如果项目启用了
baseline,两个任务读取的是同一份lint-baseline.xml,但匹配逻辑受 variant 编译配置影响,可能有细微差异
为什么 abortOnError true 有时不生效
常见原因不是配置写错,而是 lint 任务本身没被真正执行到。Gradle 构建流程中,lint 是一个独立的 verification task,并不自动绑定到 assemble 或 build 生命周期里。所以即使你设了 abortOnError true,只要没显式调用 lint 任务,构建照样通过。
通过会话感知的CLI驱动真实的移动应用,使代理能够检查UI状态、确定性地操作,并在调试过程中收集日志、网络跟踪和性能证据。
解决办法是明确依赖关系:
- 在
app/build.gradle中加:tasks.named("assembleDebug").configure { dependsOn("lintDebug") } - 或更通用的写法:
tasks.withType(com.android.build.gradle.tasks.Lint).configureEach { abortOnError = true } - 注意:不要用
lintOptions.abortOnError = true后就以为万事大吉,它只控制 lint 任务内部行为,不控制是否运行该任务
HTML 报告打不开?检查 htmlOutput 路径和编码
默认生成的 lint-results.html 用浏览器直接双击打开可能报错或乱码,因为文件路径含空格或中文、或缺少 file:// 协议前缀。更稳妥的做法是:
- 用命令行指定输出位置:
./gradlew lintDebug --no-daemon -Pandroid.lintHtmlOutput=build/reports/lint-debug.html - 确保
htmlOutput配置值是相对路径(如file("build/reports/my-lint.html")),避免绝对路径导致跨机器失效 - 生成后用
open build/reports/lint-debug.html(macOS)或start build\reports\lint-debug.html(Windows)唤起浏览器,比双击更可靠
真正容易被忽略的是 baseline 文件的更新时机:每次手动改了 lint-baseline.xml,必须重新运行 lint 才会按新 baseline 过滤问题;否则旧缓存仍生效,你会误以为某条规则“失效”了。

















