如何通过命令行对指定文件运行Android Lint检查

原生./gradlew lint命令默认不支持直接传入零散文件路径做定向扫描，可通过以下两种方案实现仅对指定/变更文件执行Lint检查，适配Git提交前增量校验的场景：

Android Gradle Plugin 8.0及以上版本原生支持传入待检查文件列表参数，不需要自定义任务，直接执行命令即可：

./gradlew lint<构建变体名> -Pandroid.lint.include="文件1相对路径,文件2相对路径"

示例：仅检查Debug变体下的Test.kt和activity_main.xml两个文件

./gradlew lintDebug -Pandroid.lint.include="app/src/main/java/com/demo/Test.kt,app/src/main/res/layout/activity_main.xml"

配合pre-commit钩子使用时，只需要先通过git命令拿到暂存区的变更文件列表，拼接成逗号分隔的字符串传入上述参数即可。

如果使用AGP 8.0以下版本，可通过自定义Lint任务实现文件过滤：

1. 在对应模块的build.gradle中注册自定义Lint任务，支持接收外部传入的文件列表：

tasks.register('lintChangedFiles', Lint) {
    // 读取外部传入的待检查文件列表，多个文件用逗号分隔
    def changedFilePaths = project.findProperty("lintFiles")?.split(",") ?: []
    // 无待检查文件时直接跳过任务，避免触发全量扫描
    if (changedFilePaths.isEmpty()) {
        enabled = false
        return
    }
    // 过滤出当前模块范围内、属于Lint支持的代码/资源文件
    def moduleRootPath = project.projectDir.absolutePath
    def validFiles = changedFilePaths.findAll { filePath ->
        filePath.startsWith(moduleRootPath) && (filePath.endsWith(".kt") || filePath.endsWith(".java") || filePath.endsWith(".xml"))
    }.collect { filePath ->
        filePath.replace(moduleRootPath + File.separator, "")
    }
    if (validFiles.isEmpty()) {
        enabled = false
        return
    }
    // 配置Lint仅扫描传入的有效文件
    lintOptions {
        check *validFiles
    }
}

2. 编写Git pre-commit钩子脚本（存放路径为项目下.git/hooks/pre-commit，需添加可执行权限），在提交时自动拉取暂存区变更文件传入Lint任务：

#!/bin/sh
# 提取暂存区中新增/修改的代码、资源文件绝对路径
STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(kt|java|xml)$' | sed "s|^|$(pwd)/|")

if [ -z "$STAGED_FILES" ]; then
    exit 0
fi

# 执行增量Lint检查
./gradlew lintChangedFiles -PlintFiles="$STAGED_FILES" -q

# 检查Lint执行结果，存在问题则阻断提交
if [ $? -ne 0 ]; then
    echo "变更文件存在Lint规则违规，请修复后重新提交"
    exit 1
fi
exit 0

• 多模块项目使用自定义任务时，需要先根据文件路径判断所属模块，再到对应模块目录下执行Lint任务，也可在根级build.gradle中编写跨模块任务分发逻辑
• 可根据项目需求调整文件过滤规则，比如增加对其他类型资源文件、构建配置文件的检查支持
• 建议配置Lint基线文件，过滤项目中存在的历史遗留问题，避免增量检查时被旧问题阻断提交

内容的提问来源于stack exchange，提问作者Pranav Kapoor