Flutter macOS构建缓存清理有五种方法：一、flutter clean命令清除项目build/和.dart_tool/；二、手动rm -rf删除；三、清理$TMPDIR中过期flutter_tools目录；四、用trash脚本递归清build文件夹；五、清除Xcode DerivedData。
在macOS上进行Flutter开发时，你是否遇到过项目构建速度逐渐变慢、磁盘空间被大量占用，或是频繁出现难以定位的编译错误？这些问题往往源于长期积累的构建缓存。本文将详细介绍五种在macOS上彻底清理Flutter构建缓存的有效方法，帮助你释放磁盘空间并提升开发效率。
一、执行 flutter clean 命令
这是Flutter官方推荐的标准清理方法，安全且可逆。该命令仅清除项目的构建产物和工具缓存，不会影响你的源代码和配置文件。
操作步骤如下：
1. 打开终端，使用cd命令进入你的Flutter项目根目录。
2. 输入并执行以下命令：
flutter clean
3. 等待命令执行完成，当终端显示类似“Removed build/ and .dart_tool/ directories”的提示时，表示清理成功。
4. 清理完成后，如需重新构建项目，可运行flutter build ios或flutter run命令。
二、手动删除 build 和 .dart_tool 目录
当flutter clean命令因权限或其他问题无法执行时，手动删除是最直接的解决方案。此方法能确保彻底清理相关缓存目录。
具体操作：
1. 在项目根目录下，执行以下命令删除构建目录：
rm -rf build/
2. 接着，删除Dart工具缓存目录：
rm -rf .dart_tool/
建议在执行删除前，先使用ls -la命令确认build/和.dart_tool/目录的存在，并检查其中是否包含重要文件。
三、清理全局 Flutter 工具临时缓存（flutter_tools）
Flutter命令行工具在运行时会在系统临时目录（如/tmp或$TMPDIR）中生成以flutter_tools开头的临时工作目录。这些目录长期积累可能占用数GB的磁盘空间。
清理方法如下：
1. 首先，查看系统临时目录路径：
echo $TMPDIR
2. 查找所有相关的临时目录：
find “$TMPDIR” -type d -name “flutter_tools*”
3. 为安全起见，可先删除修改时间超过30天的旧缓存：
find “$TMPDIR” -type d -name “flutter_tools*” -mtime +30 -exec rm -rf {} \;
4. 若确认当前无Flutter进程运行，可一次性清空所有相关缓存：
find “$TMPDIR” -type d -name “flutter_tools*” -exec rm -rf {} \;
四、使用 delete_build_folder.sh 脚本批量清理
对于包含多个子模块或插件的大型Flutter项目，手动查找并删除所有build文件夹效率低下。使用macOS专用脚本可以递归扫描并安全清理。
操作流程：
1. 首先，确保系统已安装trash命令（可通过Homebrew安装）：
brew install trash
2. 创建或下载名为delete_build_folder.sh的脚本文件，其核心内容为：find . -name “build” -type d -exec trash {} \;。
3. 为脚本添加执行权限：
chmod +x delete_build_folder.sh
4. 在项目根目录下运行脚本：
./delete_build_folder.sh
五、清理 Xcode 衍生数据（iOS 构建相关）
对于Flutter iOS应用开发者，清理Xcode的DerivedData目录至关重要。该目录存储了编译中间文件、索引和模拟器缓存，体积增长迅速，是导致构建失败和速度缓慢的常见原因。
清理步骤：
1. 首先，关闭Xcode及所有iOS模拟器。
2. 在终端中执行以下命令，清空整个衍生数据目录：
rm -rf ~/Library/Developer/Xcode/DerivedData/*
3. 若只想清理特定项目的数据，避免影响其他项目，可先列出目录内容：
ls -t ~/Library/Developer/Xcode/DerivedData/ | head -n 10
4. 找到目标项目对应的文件夹（通常包含项目名，如Runner-*），然后进行针对性删除：
rm -rf ~/Library/Developer/Xcode/DerivedData/Runner-*
