以下是為 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 開發環境將被徹底清除,為全新安裝或切換其他框架鋪平道路。