【Flutter】Flutter 常用命令 ( 官方文档 | 环境与版本管理 | 项目创建与清理 | 设备与运行 | 构建与打包 | 环境与版本管理 | 代码管理 | 其它命令 )

参考文档 :

• Flutter 官方文档 : https://docs.flutter.dev/install/quick
• 使用出现网络问题 , 参考 在中国网络环境下使用 Flutter 文档
• Flutter 命令行 文档 :https://docs.flutter.cn/reference/flutter-cli

flutter 命令总结 :

• 环境 :doctor/upgrade/channel
• 项目 :create/clean
• 运行 :devices/run
• 依赖 :pub get/pub add
• 打包 :build apk/build ipa/build web

flutter 命令流程 :

• 创建 Flutter 项目 :flutter create my_flutter_app
• 查看已连接设备 :flutter devices
• 运行项目 :运行到默认设备flutter run, 指定运行设备类型flutter run -d chrome, 指定运行设备 IDflutter run -d 设备ID
• 编译打包 :编译 Androidflutter build apk --release, 编译 iOSflutter build ios --release, 编译 Webflutter build web --release

强烈建议使用 命令行 进行 Flutter 项目的 编译调试 , 使用 Android Studio 或者 Visual Studio Code 进行 Flutter 命令操作 , 会增加内存消耗 , 进程会吃掉 3G 的内存 ;

一、官方文档

本篇博客可参考Flutter 命令行 文档 :https://docs.flutter.cn/reference/flutter-cli

英文官方 CLI 参考 : https://docs.flutter.dev/reference/flutter-cli ( 仅作参考 )

该文档在 Flutter 文档中的 " 参考资料 / Flutter CLI 命令行文档 " 模块 中 ;

二、环境与版本管理

1、环境检查

flutter doctor# 检查环境是否完整 ( Android SDK、Xcode、工具链等 )flutter doctor-v# 详细模式 , 输出更多日志

2、版本与渠道

flutter--version# 查看当前 Flutter 版本flutter channel# 查看当前渠道 ( stable/beta/dev/master )flutter channel stable# 切换到稳定渠道 ( 推荐日常开发 )flutter upgrade# 升级 Flutter SDK 到当前渠道最新版

3、全局配置

flutter config --android-sdk<路径># 指定 Android SDK 路径flutter config --no-analytics# 关闭数据收集flutter config --enable-web# 启用 Web 支持

三、项目创建与清理

1、创建项目

flutter create my_app# 创建标准项目 ( 含示例代码 )flutter create--emptymy_empty_app# 创建空项目 ( 最简 main.dart )flutter create--orgcom.xxx my_app# 指定包名 ( Android/iOS )flutter create-iswift-akotlin my_app# iOS 用 Swift , Android 用 Kotlin

2、清理缓存

flutter clean# 删除 build/、.dart_tool/ 等缓存目录 ( 解决编译异常 )

四、设备与运行 ( ★ 重点 ★ )

1、 查看设备

flutter devices# 列出所有已连接设备 ( 手机、模拟器、桌面 )

2、 运行项目

flutter run# 自动选择设备运行 ( 有多个设备时会提示选择 )flutter run-d<设备ID># 指定设备运行 ( ID 来自 flutter devices )flutter run-dchrome# 直接运行到 Chrome ( Web )flutter run--release# 以发布模式运行 ( 性能好、无热重载 )flutter run--debug# 调试模式 ( 默认 , 支持热重载 )flutter run--profile# 性能分析模式

使用 print/debugPrint 打印的日志信息 , 在 命令行终端 和 Chrome Console 都有 ;

3、 热重载 / 热重启

热重载 / 热重启 命令 :

• 运行中按r: 热重载 ( 保留状态 )
• 运行中按R: 热重启 ( 重置状态 )
• 运行中按q: 退出

运行限制 :

• debug / profile :有调试信息 → 支持 热重载 / 热重启
• release :为了极致性能 → 关闭了调试功能 → 按 r 没反应

运行后 , 会提示可用的命令 ;

运行时 , 输入 q , 按回车 , 就会退出调试 :

4、 附加到正在运行的 App

flutter attach-d<设备ID>

该命令 是 “连到已经在跑的 Flutter App” , 给它加上调试能力 ( 热重载、断点、日志、DevTools ) , 不用重新 flutter run 启动一次。

连接到正在运行的 Flutter App ( Debug 模式 )

• App 已经在设备 / 模拟器上跑着 ( 可能是flutter run起的 , 也可能是 Native 壳启动的 Flutter 模块 )
• attach不重启 App , 只连接它的Dart VM 调试服务

获得完整调试能力( 和flutter run一样 )

• r: 热重载 ( 保留状态 )
• R: 热重启 ( 重置状态 )
• q: 退出 App
• v: 打开 Dart DevTools ( 性能 / 网络 / UI 调试 )
• 终端能看到print/debugPrint日志

典型场景 : 混合开发 ( Add-to-App )

• 主 App 是 Android/iOS Native , 里面嵌入 Flutter 模块
• 用 Android Studio/Xcode 把 Native 项目跑起来 → Flutter 页面已加载
• 这时不能用flutter run( 会覆盖 Native 工程 )
• 只能用 :flutter attach -d 设备ID命令链接上去 , 然后直接热重载 Flutter 代码 , Native 部分不动 ;

五、发布命令 : 构建与打包

1、Android 打包

# 调试版 APKflutter build apk--debug# 发布版 APK ( 默认 )flutter build apk--release# 仅打包 64 位架构 ( 现代安卓 )flutter build apk --target-platform android-arm64# Android App Bundle ( Google Play 上传 )flutter build appbundle--release

2、iOS 打包 ( Mac 必需 )

# 生成 IPA ( 用于 App Store/企业分发 )flutter build ipa--release# 构建 iOS 工程 ( .xcworkspace )flutter build ios--release

3、桌面端打包

桌面端打包 分为在 Windows 端 / MacOS 端 / Linux 端 三种操作系统的桌面打包 ;

# Windowsflutter build windows--release# macOSflutter build macos--release# Linuxflutter build linux--release

4、Web 打包

flutter build web--release

六、环境与版本管理

1、依赖管理 ( pub 命令 )

flutter pub get# 拉取 pubspec.yaml 依赖 ( 最常用 )flutter pub upgrade# 升级所有依赖到兼容最新版flutter pub upgrade 包名# 升级指定包flutter pubadd包名# 添加依赖 ( 自动写入 pubspec )flutter pub remove 包名# 移除依赖flutter pub outdated# 检查可更新依赖flutter pub deps# 查看依赖树

七、代码管理

1、代码分析 ( 检查语法 / 规范错误 )

flutter analyze

2、格式化代码

flutterformat.

3、单元测试

fluttertest# 运行所有测试fluttertesttest/xxx_test.dart# 运行单个测试文件fluttertest--coverage# 生成覆盖率报告

八、其他命令

flutter bash-completion# 生成 shell 自动补全脚本flutter assemble# 底层资源编译 ( 少见 )flutter docs# 打开本地/官方文档