彻底清除Mac上Flutter SDK需五步:一、终止dart/flutter相关进程并重启终端;二、删除SDK目录及/usr/local/bin下软链接;三、清理~/Library中Caches、Application Support等路径的Flutter残留;四、从shell配置文件(如.zshrc)中移除PATH相关行并重载;五、清除~/.pub-cache、停用全局包,并卸载IDE插件及配置。

如果您在Mac上卸载了Flutter SDK,但发现终端仍可调用flutter命令、项目缓存未清除、或重新安装后继承旧配置,则很可能是SDK及其关联文件未被彻底清理。以下是针对macOS系统完全清除Flutter SDK残留的具体操作步骤:
一、终止相关进程并退出IDE及终端会话
确保Flutter相关后台任务(如dart分析服务、模拟器、VS Code/Android Studio的Dart插件进程)已停止,避免文件被占用导致删除失败或残留。
1、打开“活动监视器”,在右上角搜索栏输入dart、flutter、simulator等关键词。
2、选中所有匹配进程,点击左上角“X”按钮,选择“强制退出”。
3、关闭所有正在运行的VS Code、Android Studio、Terminal窗口,并重启终端应用以重置PATH环境变量。
二、删除Flutter SDK主目录及全局可执行文件
Flutter通常通过git克隆方式安装于用户目录下,其bin目录会被添加至PATH;必须手动移除主SDK文件夹及符号链接,否则命令仍可执行。
1、在终端中执行命令查看当前Flutter路径:which flutter,记录返回路径(如/Users/xxx/flutter/bin/flutter)。
2、根据该路径逐级向上定位SDK根目录(通常是/Users/xxx/flutter),执行:sudo rm -rf /Users/xxx/flutter(将xxx替换为实际用户名)。
3、删除全局软链接:sudo rm /usr/local/bin/flutter、sudo rm /usr/local/bin/dart(若存在)。
三、清理用户级配置与缓存路径下的Flutter残留
Flutter会在~/Library下生成大量用户专属文件,包括缓存、日志、包存储及IDE插件状态,这些不会随SDK目录删除而自动清除。
1、按Shift+Command+G打开“前往文件夹”,依次输入以下路径并回车进入:
~/Library/Caches/flutter
~/Library/Application Support/Flutter
~/Library/Preferences/Flutter
~/Library/Logs/Flutter
2、在每个路径中搜索含flutter、dart、pub的文件夹或.plist文件,将其全部拖入废纸篓。
3、特别检查~/Library/Preferences中是否存在com.google.dart.*.plist或io.flutter.*.plist类文件,一并删除。
四、清除Shell环境变量中的Flutter配置
Flutter安装时通常会修改shell配置文件(如~/.zshrc、~/.bash_profile或~/.profile),需手动移除对应行,否则PATH仍指向已删除路径。
1、在终端中执行:ls -a ~ | grep -E "zshrc|bash|profile",确认当前shell配置文件名。
2、使用文本编辑器打开该文件,例如:nano ~/.zshrc。
3、查找包含export PATH=.*flutter.*或export PATH=.*dart.*的行,整行删除。
4、保存并退出,执行:source ~/.zshrc使更改立即生效。
五、清理Pub缓存与全局包及IDE插件状态
Flutter的包管理器pub独立维护缓存和全局激活包,这些文件位于用户目录下,且不受SDK目录删除影响,必须单独清除。
1、删除pub全局缓存:rm -rf ~/.pub-cache。
2、清除已全局激活的Flutter相关命令(如webdev、stagehand):dart pub global deactivate --all。
3、在VS Code中卸载Dart与Flutter扩展:打开扩展面板(Cmd+Shift+X),搜索Dart和Flutter,点击“卸载”图标。
4、删除VS Code工作区设置中残留的Flutter配置:打开~/Library/Application Support/Code/User/settings.json,移除含"dart."或"flutter."的配置项。



















