在 Flutter 开发中,命令行是每天都要打交道的工具。从清理缓存、安装依赖、运行项目,到打包发布、查看设备、问题排查,熟练掌握常用命令,能大幅提升开发效率,解决大部分“玄学报错”。
这篇文章整理了最实用、高频的 Flutter 命令行,从基础到进阶,新手也能直接上手用。
一、项目基础运行三剑客(必背)
这三条是开发中使用频率最高的命令,几乎每次写代码都会用到。
1. flutter clean
作用:清理项目编译缓存、构建产物与临时文件。
- 删除
build/、.dart_tool/等缓存目录 - 解决大部分因缓存导致的编译异常、资源不更新问题
使用场景:
项目编译报错、切换分支/Flutter 版本、依赖冲突时。
flutter clean
2. flutter pub get
作用:根据 pubspec.yaml 下载、同步所有项目依赖与资源。
等同于前端 npm install、yarn install。
使用场景:
首次拉取项目、新增/删除依赖、修改资源配置、执行 flutter clean 后。
flutter pub get
3. flutter run
作用:编译并运行项目到模拟器/真机,进入调试模式。
常用操作:
– 热重载:输入 r
– 全量重启:输入 R
– 退出运行:输入 q
常用命令:
# 默认运行
flutter run
# 指定设备运行(多设备时)
flutter run -d 设备ID
# 以 release 模式运行
flutter run --release
二、依赖与版本管理命令
1. flutter pub upgrade
作用:升级项目所有依赖包到最新兼容版本。
flutter pub upgrade
2. flutter pub outdated
作用:检查项目依赖,查看哪些包可升级、当前版本情况。
flutter pub outdated
3. flutter –version
作用:查看当前 Flutter 版本、Dart 版本、环境配置。
flutter --version
4. flutter channel
作用:查看/切换 Flutter 渠道(stable、beta、dev 等)。
# 查看当前渠道
flutter channel
# 切换到稳定版
flutter channel stable
flutter upgrade
三、设备与调试相关命令
1. flutter devices
作用:查看当前电脑连接的所有设备(真机、模拟器)。
flutter devices
2. flutter logs
作用:实时查看 App 运行日志,用于调试、排查崩溃问题。
flutter logs
3. flutter install
作用:仅编译安装 App 到设备,不启动日志监听。
flutter install
四、打包发布命令(上线必备)
1. Android 打包
# 打 release 包(aar/apk)
flutter build apk
# 打拆分 apk(按架构)
flutter build apk --split-per-abi
2. iOS 打包
flutter build ios --release
3. Web 打包
flutter build web --release
4. 桌面端打包
# Windows
flutter build windows
# macOS
flutter build macos
# Linux
flutter build linux
五、项目创建与诊断命令
1. flutter create
作用:创建新的 Flutter 项目。
flutter create 项目名
2. flutter doctor
作用:检查 Flutter 环境是否配置完整,提示缺失的工具(如 Android Studio、Xcode、模拟器等)。
flutter doctor
3. flutter analyze
作用:静态代码分析,检查代码语法、规范、潜在问题。
flutter analyze
六、开发最实用组合命令
遇到项目运行异常、编译失败、依赖不生效时,直接执行这套“万能组合”,能解决绝大多数问题:
flutter clean
flutter pub get
flutter run
七、总结
- flutter clean:清理缓存,解决编译异常
- flutter pub get:安装依赖,同步配置
- flutter run:运行项目,调试开发
- flutter build:打包发布,生成安装包
- flutter doctor:检查环境,排查配置问题
熟记这些命令,Flutter 开发会更顺畅,少走弯路、少踩坑。
需要我帮你把这篇博客生成可直接发布的 Markdown 文件,或者整理成一页速查清单图吗?





