清晰易懂的 Flutter 卸载和清理教程

发布于:2025-04-07 ⋅ 阅读:(17) ⋅ 点赞:(0)

以下是为 Flutter 彻底卸载与清理教程,覆盖 Windows、macOS、Linux 系统,步骤清晰无残留,确保完全删除 Flutter SDK、依赖工具及 IDE 配置。


一、通用步骤:确认 Flutter 安装方式

Flutter 通常通过以下方式安装:

  1. 手动下载 SDK 压缩包(主流方式)
  2. Git 克隆仓库git clone https://github.com/flutter/flutter.git
  3. 包管理器(如 macOS 的 Homebrew、Linux 的 Snap)
  4. IDE 集成(如 Android Studio、VS Code 插件)

二、Windows 系统卸载 Flutter

步骤 1:删除 Flutter SDK 目录

  1. 找到 Flutter 安装路径(默认通常为 C:\src\flutter 或自定义路径)。
  2. 直接删除整个 flutter 文件夹:
    # 示例路径(替换为你的实际路径)
    Remove-Item -Recurse -Force C:\src\flutter
    

步骤 2:清理环境变量

  1. 右键“此电脑” → 属性 → 高级系统设置 → 环境变量。
  2. 删除以下条目
    • 用户变量系统变量 中的 Path:移除指向 Flutter 的路径(如 C:\src\flutter\bin)。
    • 删除自定义变量 FLUTTER_HOME(如果存在)。

步骤 3:删除 Flutter 缓存和配置

  1. 清理用户目录下的缓存:
    Remove-Item -Recurse -Force $env:APPDATA\Pub\Cache    # Dart 包缓存
    Remove-Item -Recurse -Force $env:USERPROFILE\.flutter # 配置文件
    

步骤 4:IDE 清理

  1. VS Code
    • 卸载扩展:FlutterDart
    • 删除配置文件:%APPDATA%\Code\User\settings.json 中移除 Flutter 相关配置。
  2. Android Studio
    • 打开 FileSettingsPlugins → 卸载 Flutter 插件。

三、macOS 系统卸载 Flutter

步骤 1:删除 Flutter SDK 目录

  1. 找到安装路径(默认通常为 ~/development/flutter):
    rm -rf ~/development/flutter
    

步骤 2:清理环境变量

  1. 编辑 Shell 配置文件(如 ~/.zshrc~/.bash_profile):
    nano ~/.zshrc
    
  2. 删除或注释以下内容:
    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

  1. 如果通过 Homebrew 安装:
    brew uninstall flutter
    brew cleanup
    

四、Linux 系统卸载 Flutter

步骤 1:删除 Flutter SDK 目录

  1. 找到安装路径(默认通常为 ~/development/flutter):
    sudo rm -rf ~/development/flutter
    

步骤 2:清理环境变量

  1. 编辑 Shell 配置文件(如 ~/.bashrc):
    nano ~/.bashrc
    
  2. 删除或注释以下内容:
    export PATH="$PATH:$HOME/development/flutter/bin"
    

步骤 3:清理缓存和配置

rm -rf ~/.pub-cache
rm -rf ~/.flutter

步骤 4:通过 Snap 卸载(如果适用)

sudo snap remove flutter

五、可选:清理 Android 开发环境

警告:仅需在不再需要 Android 开发时执行!

  1. 卸载 Android Studio
    • macOS/Linux:删除安装目录(如 /Applications/Android Studio.app)。
    • Windows:通过控制面板卸载。
  2. 删除 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 独立安装)

七、附加提醒

  1. 备份项目:卸载前备份 Flutter 项目代码(lib/pubspec.yaml 等)。
  2. 版本管理工具
    • 如果使用 fvm(Flutter Version Management),运行:
      fvm flutter clean
      rm -rf ~/.fvm
      
  3. iOS 开发工具(macOS):
    • 如需保留 Xcode,无需额外操作;否则参考前文 Swift 卸载教程 清理。

八、常见问题解决

  1. 卸载后仍能运行 flutter 命令
    • 检查残留路径:which flutter → 手动删除对应文件。
  2. 重装时报权限错误
    • 确保旧目录已完全删除:sudo rm -rf <路径>(Linux/macOS)。

九、总结

  • 核心操作:删除 SDK 目录 → 清理环境变量 → 清除缓存和 IDE 配置。
  • 关键点
    • Windows:检查 AppData 下的隐藏缓存。
    • macOS/Linux:区分手动安装和包管理器安装。
    • 通用:IDE 插件需单独卸载。

按此操作后,Flutter 开发环境将被彻底清除,为全新安装或切换其他框架铺平道路。