以下是为 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
文件夹:# 示例路径(替换为你的实际路径) Remove-Item -Recurse -Force C:\src\flutter
步骤 2:清理环境变量
- 右键“此电脑” → 属性 → 高级系统设置 → 环境变量。
- 删除以下条目:
- 用户变量 和 系统变量 中的
Path
:移除指向 Flutter 的路径(如C:\src\flutter\bin
)。 - 删除自定义变量
FLUTTER_HOME
(如果存在)。
- 用户变量 和 系统变量 中的
步骤 3:删除 Flutter 缓存和配置
- 清理用户目录下的缓存:
Remove-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
):rm -rf ~/development/flutter
步骤 2:清理环境变量
- 编辑 Shell 配置文件(如
~/.zshrc
或~/.bash_profile
):nano ~/.zshrc
- 删除或注释以下内容:
export PATH="$PATH:$HOME/development/flutter/bin" export FLUTTER_HOME="$HOME/development/flutter"
步骤 3:删除缓存和依赖
rm -rf ~/.pub-cache # Dart 包缓存
rm -rf ~/.flutter # 用户配置
rm -rf ~/Library/Caches/flutter # 系统缓存
步骤 4:清理通过 Homebrew 安装的 Flutter
- 如果通过 Homebrew 安装:
brew uninstall flutter brew cleanup
四、Linux 系统卸载 Flutter
步骤 1:删除 Flutter SDK 目录
- 找到安装路径(默认通常为
~/development/flutter
):sudo rm -rf ~/development/flutter
步骤 2:清理环境变量
- 编辑 Shell 配置文件(如
~/.bashrc
):nano ~/.bashrc
- 删除或注释以下内容:
export PATH="$PATH:$HOME/development/flutter/bin"
步骤 3:清理缓存和配置
rm -rf ~/.pub-cache
rm -rf ~/.flutter
步骤 4:通过 Snap 卸载(如果适用)
sudo snap remove flutter
五、可选:清理 Android 开发环境
警告:仅需在不再需要 Android 开发时执行!
- 卸载 Android Studio:
- macOS/Linux:删除安装目录(如
/Applications/Android Studio.app
)。 - Windows:通过控制面板卸载。
- macOS/Linux:删除安装目录(如
- 删除 Android SDK:
# 默认路径 rm -rf ~/Library/Android # macOS rm -rf ~/Android # Linux rm -rf C:\Users\<用户>\AppData\Local\Android # Windows
六、验证是否卸载成功
在终端或命令提示符中运行:
flutter --version # 应提示 "command not found"
dart --version # 同上(如果 Dart 独立安装)
七、附加提醒
- 备份项目:卸载前备份 Flutter 项目代码(
lib/
、pubspec.yaml
等)。 - 版本管理工具:
- 如果使用
fvm
(Flutter Version Management),运行:fvm 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 开发环境将被彻底清除,为全新安装或切换其他框架铺平道路。