Mac清理Flutter构建缓存教程 苹果电脑释放磁盘空间

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-*