一、常见编译产物
Android 项目的编译产物主要包括：
- build/ 目录：包含编译生成的 class 文件、APK/AAB、资源文件等
- .gradle/ 目录：Gradle 缓存和配置文件
- local.properties ：本地配置文件（包含 SDK 路径等）
- IDE 生成文件： .idea/ 、 *.iml 、 *.ipr 、 *.iws 等
- 构建工具生成的临时文件：如 out/ 、 bin/ 等
- Maven 本地仓库缓存：如 maven/ 目录（部分项目）
二、清理方案
1. 使用 Gradle 命令
最推荐的方式 ，适用于所有 Gradle 项目：
# 清理所有构建产物
./gradlew clean
# 清理并重新构建
./gradlew clean build
# 清理并重新生成依赖
./gradlew clean build --refresh-dependencies
优势 ：
- 自动化处理，无需手动操作
- 只清理构建产物，保留源代码和配置
- 跨平台兼容（Windows/macOS/Linux）
2. 手动删除构建目录
适用于快速清理或 Gradle 命令不可用的场景：
# 删除 build 目录
rm -rf build/
# 删除所有模块的 build 目录
find . -name "build" -type d -exec rm -rf {} \;
# 删除 .gradle 目录（谨慎使用，会清除缓存）
rm -rf .gradle/
注意 ：
- 手动删除可能会误删重要文件
- 删除 .gradle 目录后需要重新下载依赖，会增加构建时间
3. 使用 Git 清理命令
适用于使用 Git 版本控制的项目：
# 清理未跟踪的文件和目录
git clean -f
# 清理未跟踪的文件和目录（包括忽略的文件）
git clean -fdx
# 重置所有修改过的文件
git checkout .
优势 ：
可以同时清理构建产物和 IDE 生成文件
确保工作目录与版本库一致
注意 ：会删除所有未提交的更改，使用前需确认
不会删除已提交的文件
4. IDE 内置清理功能
Android Studio ：
选择 Build > Clean Project
选择 Build > Rebuild Project
选择 File > Invalidate Caches / Restart... （清理缓存并重启）
优势 ：操作简单，适合不熟悉命令行的用户
可以清理 IDE 缓存，解决一些构建问题
5. 自定义清理脚本
对于复杂项目，可以创建自定义清理脚本：
clean.sh （Linux/macOS） ：
#!/bin/bash
echo "Cleaning build artifacts..."
./gradlew clean
rm -rf .gradle/
rm -rf .idea/
rm -f *.iml
rm -f local.properties
echo "Clean completed!"
clean.bat （Windows） ：
@echo off
echo Cleaning build artifacts...
gradlew clean
rd /s /q .gradle
rd /s /q .idea
del /q *.iml
del /q local.properties
echo Clean completed!
优势 ：
- 可以根据项目需求定制清理内容
- 一键执行，方便快捷
三、清理策略建议
1. 日常开发
- 使用 ./gradlew clean 清理构建产物
- 遇到构建问题时使用 File > Invalidate Caches / Restart...
2. 版本切换或分支合并
- 使用 git clean -fdx 清理所有未跟踪文件
- 然后执行 ./gradlew clean build 重新构建
3. 发布前
- 执行 ./gradlew clean build 确保构建产物干净
- 检查 local.properties 等敏感文件是否被包含在版本控制中
4. 依赖更新后
- 执行 ./gradlew clean build --refresh-dependencies 强制更新依赖
四、注意事项
-
保留必要文件 ：
- local.properties ：包含 SDK 路径，建议添加到 .gitignore
- .gitignore ：确保正确配置，避免提交构建产物
- 第三方库的本地修改：如果有修改第三方库，需谨慎清理
-
清理后影响 ：
- 清理后首次构建会较慢，因为需要重新编译和下载依赖
- 可能需要重新导入项目到 IDE
-
跨平台兼容性 ：
- Windows 系统使用 gradlew.bat 而不是 ./gradlew
- 路径分隔符在不同系统中不同（Windows 使用 \ ，Unix 系统使用 / ）
-
安全性 ：
- 执行删除命令前确认路径正确，避免误删系统文件
- 使用 Git 清理命令前确保未提交的更改已备份
五、总结
清理方式 适用场景 优势 注意事项 Gradle 命令 日常开发 自动化、安全 需安装 Gradle 手动删除 快速清理 灵活 易误删文件 Git 命令 版本控制 与版本库一致 会删除未提交更改 IDE 功能 图形界面操作 简单直观 清理范围有限 自定义脚本 复杂项目 定制化 需要维护脚本
