flutter 常用命令行速查指南

2025-07-03 0 阅读2分钟

Flutter 常用命令行速查指南

1.🛠️ 项目创建与管理

命令	说明	示例
`flutter create <project_name>`	创建带示例代码的新项目	`flutter create my_app`
`flutter create --empty <name>`	创建空项目（无示例代码）	`flutter create --empty demo`
`flutter create -i swift -a kotlin`	指定平台开发语言（iOS/Android）	`flutter create -i swift -a kotlin app`2
`flutter clean`	清除构建缓存（解决编译异常）	`flutter clean`1
`flutter config --platforms=web`	为现有项目添加新平台支持	`flutter config --platforms=web,android`2

2.▶️ 运行与调试

命令	说明	快捷键/参数
`flutter run`	在默认设备运行项目	-
`flutter run -d <device_id>`	指定设备运行	`flutter run -d iPhone14`1
`flutter attach`	附加到运行中的 App 调试	-
热重载 🔄	保留应用状态更新代码	运行中按 `r`1
热重启 🔁	重置应用状态并重启	运行中按 `R`1
`flutter logs`	查看设备运行日志	`flutter logs -d emulator-5554`

3.📦 依赖管理

命令	功能	使用场景
`flutter pub get`	安装 `pubspec.yaml` 中的依赖	新增依赖后必执行1
`flutter pub upgrade`	升级依赖到最新版本	定期更新兼容性1
`flutter pub add <package>`	添加新依赖包	`flutter pub add http`
`flutter pub remove <package>`	移除依赖包	`flutter pub remove http`

4.⚙️ 构建与发布

命令	输出类型	说明
`flutter build apk`	Android APK	默认 ARM 架构1
`flutter build apk --target-platform android-arm64`	指定 CPU 架构 APK	适配 64 位设备
`flutter build ios`	iOS IPA 包	需 Xcode 环境1
`flutter build web`	Web 应用	生成 `/build/web` 目录

5.🔍 环境与设备管理

命令	功能	关键操作
`flutter doctor`	检查环境配置状态	显示缺失工具链1
`flutter devices`	列出可用设备	含真机/模拟器 ID1
`flutter emulators --launch <id>`	启动指定模拟器	`flutter emulators --launch Pixel_5`1
`flutter upgrade`	升级 Flutter SDK	更新到最新稳定版1
`flutter channel stable`	切换 SDK 更新渠道	`stable/beta/dev/master`1

6.🧪 测试与代码质量

命令	作用	示例
`flutter test`	运行所有单元测试	-
`flutter test test/widget_test.dart`	运行指定测试文件	-
`flutter analyze`	静态代码分析	检测语法错误1
`flutter format .`	格式化 Dart 代码	统一代码风格

💡 实用技巧

路径符号说明
~ 代表用户主目录（如 ~/Desktop/project 指桌面项目）
安全操作建议
对来源不明项目优先用 Preview in Safe Mode 浏览代码（禁用脚本执行）1
多平台扩展
通过 flutter create --platforms=web,android . 为现有项目添加新平台2
项目命名禁忌
避免项目名称与依赖包同名（如 flutter_markdown），否则会导致依赖冲突4

使用 flutter <command> -h 查看详细帮助（如 flutter run -h），结合 IDE 图形化操作可提升效率。