大项目中如何用Gradle命令通过ktlint格式化指定文件？

当然可以实现只格式化指定文件的需求，不用执行全量的./gradlew ktlintFormat，具体有两种常用方式：

方式一：使用ktlint内置的--include参数 #

直接在命令中通过--include指定要格式化的文件路径，支持单个或多个文件（多个用逗号分隔）：

# 格式化单个文件
./gradlew ktlintFormat --include "app/src/main/java/com/example/MyClass.kt"

# 格式化多个文件
./gradlew ktlintFormat --include "app/src/main/java/com/example/MyClass.kt","app/src/main/java/com/example/AnotherClass.kt"

注意路径要和项目根目录相对应，确保路径准确。

方式二：通过Gradle属性传递文件列表（需简单配置） #

如果项目中ktlint任务没有默认支持--include，可以通过自定义Gradle属性来实现：

1. 先在项目的build.gradle.kts（或build.gradle）中添加如下配置：

tasks.withType<org.jlleitschuh.gradle.ktlint.KtlintFormatTask> {
    if (project.hasProperty("filesToFormat")) {
        val targetFiles = project.property("filesToFormat").toString().split(",")
        source(targetFiles.map { project.file(it) })
    }
}

2. 然后执行命令时通过-P参数传递要格式化的文件：

# 单个文件
./gradlew ktlintFormat -PfilesToFormat="app/src/main/java/com/example/MyClass.kt"

# 多个文件
./gradlew ktlintFormat -PfilesToFormat="app/src/main/java/com/example/MyClass.kt,app/src/main/java/com/example/AnotherClass.kt"

这两种方式都能精准格式化指定文件，避免全量修改带来的PR体积过大问题，降低代码评审的工作量。

内容的提问来源于stack exchange，提问作者Kamal Shabanov