如何移除已删除Gradle模块的build文件？

团队删除项目中的Gradle模块后，由于build目录被加入.gitignore，本地会残留对应模块的build文件夹（比如根目录下存在xxx/build，但xxx模块文件夹已经被删除），用gradle clean清不掉——因为这些模块已经不在项目配置里，Gradle不会处理它们。

方法一：用Shell脚本批量清理（Linux/macOS） #

在项目根目录执行以下脚本，自动删除那些父模块目录已不存在的build文件夹：

find . -type d -name "build" -depth 2 | while read build_dir; do
  module_dir=$(dirname "$build_dir")
  if [ ! -d "$module_dir" ]; then
    echo "Removing orphaned build directory: $build_dir"
    rm -rf "$build_dir"
  fi
done

方法二：用批处理脚本清理（Windows） #

在项目根目录新建.bat文件，粘贴以下内容后双击运行：

@echo off
setlocal enabledelayedexpansion
for /d /r %%i in (build) do (
  set "module_dir=%%~dpi.."
  if not exist "!module_dir!" (
    echo Removing orphaned build directory: %%i
    rmdir /s /q "%%i"
  )
)
endlocal

方法三：给Gradle加自定义清理任务（跨平台） #

在根项目的构建脚本中添加自定义任务，让gradle clean自动清理残留的build目录：

Groovy版本（build.gradle） #

task cleanOrphanedBuildDirs {
  doLast {
    // 获取当前项目中所有已配置的模块名称
    def includedModules = settings.rootProject.subprojects.collect { it.name }
    // 遍历所有一级子目录下的build文件夹
    fileTree(rootDir).include("*/build").dirs.each { buildDir ->
      def moduleName = buildDir.parentFile.name
      if (!includedModules.contains(moduleName)) {
        println "Removing orphaned build dir for module '$moduleName': ${buildDir.path}"
        buildDir.deleteDir()
      }
    }
  }
}

// 让clean任务执行完后自动跑这个清理任务
clean.finalizedBy(cleanOrphanedBuildDirs)

Kotlin版本（build.gradle.kts） #

tasks.register("cleanOrphanedBuildDirs") {
  doLast {
    val includedModules = settings.rootProject.subprojects.map { it.name }
    fileTree(rootDir).include("*/build").dirs.forEach { buildDir ->
      val moduleName = buildDir.parentFile.name
      if (!includedModules.contains(moduleName)) {
        println("Removing orphaned build dir for module '$moduleName': ${buildDir.path}")
        buildDir.deleteRecursively()
      }
    }
  }
}

// 关联到clean任务
tasks.clean.finalizedBy(tasks.cleanOrphanedBuildDirs)

之后执行gradle clean，就会同时清理掉那些不在项目配置中的模块的build目录。

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