以下是为 Flutter 彻底卸载与清理教程 ,覆盖 Windows、macOS、Linux 系统,步骤清晰无残留,确保完全删除 Flutter SDK、依赖工具及 IDE 配置。
一、通用步骤:确认 Flutter 安装方式
Flutter 通常通过以下方式安装:
- 手动下载 SDK 压缩包(主流方式)
- Git 克隆仓库 (
git clone https://github.com/flutter/flutter.git
) - 包管理器(如 macOS 的 Homebrew、Linux 的 Snap)
- IDE 集成(如 Android Studio、VS Code 插件)
二、Windows 系统卸载 Flutter
步骤 1:删除 Flutter SDK 目录
-
找到 Flutter 安装路径(默认通常为
C:\src\flutter
或自定义路径)。 -
直接删除整个
flutter
文件夹:powershell# 示例路径(替换为你的实际路径) Remove-Item -Recurse -Force C:\src\flutter
步骤 2:清理环境变量
- 右键"此电脑" → 属性 → 高级系统设置 → 环境变量。
- 删除以下条目 :
- 用户变量 和 系统变量 中的
Path
:移除指向 Flutter 的路径(如C:\src\flutter\bin
)。 - 删除自定义变量
FLUTTER_HOME
(如果存在)。
- 用户变量 和 系统变量 中的
步骤 3:删除 Flutter 缓存和配置
-
清理用户目录下的缓存:
powershellRemove-Item -Recurse -Force $env:APPDATA\Pub\Cache # Dart 包缓存 Remove-Item -Recurse -Force $env:USERPROFILE\.flutter # 配置文件
步骤 4:IDE 清理
- VS Code :
- 卸载扩展:
Flutter
和Dart
。 - 删除配置文件:
%APPDATA%\Code\User\settings.json
中移除 Flutter 相关配置。
- 卸载扩展:
- Android Studio :
- 打开
File
→Settings
→Plugins
→ 卸载Flutter
插件。
- 打开
三、macOS 系统卸载 Flutter
步骤 1:删除 Flutter SDK 目录
-
找到安装路径(默认通常为
~/development/flutter
):bashrm -rf ~/development/flutter
步骤 2:清理环境变量
-
编辑 Shell 配置文件(如
~/.zshrc
或~/.bash_profile
):bashnano ~/.zshrc
-
删除或注释 以下内容:
bashexport PATH="$PATH:$HOME/development/flutter/bin" export FLUTTER_HOME="$HOME/development/flutter"
步骤 3:删除缓存和依赖
bash
rm -rf ~/.pub-cache # Dart 包缓存
rm -rf ~/.flutter # 用户配置
rm -rf ~/Library/Caches/flutter # 系统缓存
步骤 4:清理通过 Homebrew 安装的 Flutter
-
如果通过 Homebrew 安装:
bashbrew uninstall flutter brew cleanup
四、Linux 系统卸载 Flutter
步骤 1:删除 Flutter SDK 目录
-
找到安装路径(默认通常为
~/development/flutter
):bashsudo rm -rf ~/development/flutter
步骤 2:清理环境变量
-
编辑 Shell 配置文件(如
~/.bashrc
):bashnano ~/.bashrc
-
删除或注释 以下内容:
bashexport PATH="$PATH:$HOME/development/flutter/bin"
步骤 3:清理缓存和配置
bash
rm -rf ~/.pub-cache
rm -rf ~/.flutter
步骤 4:通过 Snap 卸载(如果适用)
bash
sudo snap remove flutter
五、可选:清理 Android 开发环境
警告:仅需在不再需要 Android 开发时执行!
-
卸载 Android Studio :
- macOS/Linux:删除安装目录(如
/Applications/Android Studio.app
)。 - Windows:通过控制面板卸载。
- macOS/Linux:删除安装目录(如
-
删除 Android SDK :
bash# 默认路径 rm -rf ~/Library/Android # macOS rm -rf ~/Android # Linux rm -rf C:\Users\<用户>\AppData\Local\Android # Windows
六、验证是否卸载成功
在终端或命令提示符中运行:
bash
flutter --version # 应提示 "command not found"
dart --version # 同上(如果 Dart 独立安装)
七、附加提醒
-
备份项目 :卸载前备份 Flutter 项目代码(
lib/
、pubspec.yaml
等)。 -
版本管理工具 :
-
如果使用
fvm
(Flutter Version Management),运行:bashfvm flutter clean rm -rf ~/.fvm
-
-
iOS 开发工具 (macOS):
- 如需保留 Xcode,无需额外操作;否则参考前文 Swift 卸载教程 清理。
八、常见问题解决
- 卸载后仍能运行
flutter
命令 :- 检查残留路径:
which flutter
→ 手动删除对应文件。
- 检查残留路径:
- 重装时报权限错误 :
- 确保旧目录已完全删除:
sudo rm -rf <路径>
(Linux/macOS)。
- 确保旧目录已完全删除:
九、总结
- 核心操作:删除 SDK 目录 → 清理环境变量 → 清除缓存和 IDE 配置。
- 关键点 :
- Windows :检查
AppData
下的隐藏缓存。 - macOS/Linux:区分手动安装和包管理器安装。
- 通用:IDE 插件需单独卸载。
- Windows :检查
按此操作后,Flutter 开发环境将被彻底清除,为全新安装或切换其他框架铺平道路。