前言
在 Flutter 開發中，常用指令分為 項目管理、構建、調試 和 清理工具 幾類。以下是最常用的 Flutter CLI 指令及其用途：
項目管理指令
| 指令 | 功能 | 用途 | 示例 |
|---|---|---|---|
flutter create <project_name> | 創建新的 Flutter 項目 | 初始化項目 | flutter create my_app |
flutter pub add <package_name> | 添加依賴並執行 flutter pub get | 快速添加第三方包 | flutter pub add provider |
flutter pub remove <package_name> | 從 pubspec.yaml 中刪除依賴並更新 | 清理不需要的包 | flutter pub remove provider |
flutter pub outdated | 檢查依賴是否有新版本 | 幫助保持依賴最新 | flutter pub outdated |
flutter pub upgrade | 升級所有依賴到最新版本 | 更新長期未維護項目的依賴 | flutter pub upgrade |
flutter run | 在連接設備上運行應用 | 調試代碼 | flutter run --release |
項目調教與測試
flutter analyze | 分析項目代碼，檢查語法錯誤或潛在問題 | 確保代碼質量 | flutter analyze |
flutter test | 運行單元測試和 Widget 測試 | 驗證代碼正確性 | flutter test |
flutter logs | 查看應用運行日誌 | 幫助調試應用問題 | flutter logs |
flutter attach | 附加到正在運行的應用以進行調試 | 當應用手動啟動時，使用該指令調試 | flutter attach |
構建與發佈指令
flutter build | 構建應用生成安裝文件 | 發佈應用 | flutter build apk --release |
flutter upgrade | 升級 Flutter SDK 到最新版本 | 確保 SDK 與官方一致 | flutter upgrade |
清理與維護指令
flutter config | 配置 Flutter SDK 設置 | 啟用或禁用特性 | flutter config --enable-web |
flutter clean | 清理臨時文件和構建緩存 | 修復緩存引起的問題 | flutter clean |
flutter doctor | 檢查 Flutter 安裝環境是否完整 | 解決環境配置問題 | flutter doctor |
flutter format <directory_or_file> | 格式化指定的 Dart 代碼文件 | 保持代碼風格一致 | flutter format lib/ |
Web 與桌面相關指令
flutter devices | 列出可用的調試設備 | 檢查當前可用的模擬器或實 | flutter devices |
flutter run -d <device> | 在指定設備上運行應用 | 當你有多個連接設備時，選擇具體一台 | flutter run -d chrome |
以下根據使用情境可能使用的指令組合
當應用出現奇怪問題或需要清理緩存
- 更新依賴後出現運行錯誤。
- 修改代碼後運行不符合預期。
- 懷疑緩存問題影響構建或運行。
flutter clean
flutter pub get
flutter build ios初次安裝依賴或添加新依賴
- 添加新依賴後需要將其引入項目。
- 檢查是否成功集成新功能。
flutter pub add <package_name>
flutter pub get
flutter run升級依賴到最新版本
- 檢查依賴是否有可用更新。
- 將項目中所有依賴升級到最新版本。
flutter pub outdated
flutter pub upgrade
flutter pub get
flutter run準備發佈應用（構建安裝文件）
- 準備將應用上架到 Google Play 或 App Store。
- 生成應用的安裝文件（如 APK 或 IPA）。
flutter clean
flutter pub get
flutter build apk --release
flutter build ios --release進行代碼調試
- 在真機或模擬器上運行代碼並查看運行效果。
- 查看運行時的日誌以診斷問題。
- 手動啟動應用後附加調試。
flutter run
flutter logs
flutter attach檢查開發環境配置
- 確保開發環境（如 SDK、模擬器等）已正確配置。
- 檢查是否啟用了 Web 開發等功能。
flutter doctor
flutter devices
flutter config --enable-web進行代碼檢查或優化
- 檢查代碼是否有潛在錯誤或風險。
- 保持代碼風格一致。
flutter analyze
flutter format lib/運行測試
- 為核心功能編寫測試並驗證代碼正確性。
- 確保更新代碼後不影響現有功能。
flutter test
flutter pub add test
flutter run檢查項目依賴版本狀態
- 查看哪些依賴需要升級。
- 測試最新版本的兼容性。
flutter pub outdated
flutter pub upgrade
flutter pub get快速測試特定平台的運行效果
- 在不同平台（iOS、Android、Web）上測試應用效果。
- 檢查平台相關的功能是否正常運作。
flutter run -d <device>
flutter devices
flutter build apk --debug