Flutter 常用命令大全

创建项目

bash

复制代码

# 创建新项目
flutter create <project_name>

# 创建特定平台项目
flutter create --platforms=android,ios <project_name>

# 创建插件项目
flutter create --template=plugin <plugin_name>

# 创建包项目
flutter create --template=package <package_name>

# 创建带特定组织的项目
flutter create --org com.example.myapp <project_name>

# 创建无示例代码的项目
flutter create --sample= <project_name>

项目运行

bash

复制代码

# 运行到连接的设备
flutter run

# 运行到特定设备
flutter run -d <device_id>
flutter run -d emulator-5554  # Android 模拟器
flutter run -d <device_name>  # 设备名称

# 运行到 Chrome（Web）
flutter run -d chrome

# 运行并启用热重载
flutter run --hot

# 运行并指定 flavor
flutter run --flavor dev

# 运行并查看性能数据
flutter run --profile

🔧 开发调试命令

热重载与热重启

bash

复制代码

# 终端中按 r 键进行热重载
# 终端中按 R 键进行热重启
# 终端中按 s 键保存截图
# 终端中按 q 键退出

# 热重载特定文件
flutter run --hot --pid-file /tmp/flutter.pid

# 查看运行中的应用 ID
flutter devices -v

调试工具

bash

复制代码

# 启动 Dart DevTools
flutter pub global activate devtools  # 首次激活
flutter pub global run devtools

# 或直接通过命令打开
flutter devtools

# 附加到运行中的应用
flutter attach

# 分离调试会话
detach

📱 设备管理

查看设备

bash

复制代码

# 查看所有可用设备
flutter devices

# 详细设备信息
flutter devices -v

# 查看设备日志
flutter logs

# 查看特定设备日志
flutter logs -d <device_id>

模拟器管理

bash

复制代码

# 列出所有模拟器
flutter emulators

# 启动模拟器
flutter emulators --launch <emulator_id>

# 创建模拟器
flutter emulators --create [--name x]

# 删除模拟器
flutter emulators --delete <emulator_id>

📝 代码质量与测试

静态分析

bash

复制代码

# 分析代码
flutter analyze

# 分析并修复
flutter analyze --fix

# 分析特定目录
flutter analyze lib/

# 分析并输出为 JSON
flutter analyze --write=analyzer-output.json

格式化代码

bash

复制代码

# 格式化项目代码
flutter format .

# 格式化指定文件
flutter format lib/main.dart

# 检查哪些文件需要格式化
flutter format --dry-run .

# 设置行长度
flutter format --set-exit-if-changed --line-length 100 .

测试命令

bash

复制代码

# 运行所有测试
flutter test

# 运行特定测试文件
flutter test test/unit_test.dart

# 运行测试并生成报告
flutter test --coverage

# 运行集成测试
flutter test integration_test/

# 运行测试并更新 golden 文件
flutter test --update-goldens

# 运行特定测试用例
flutter test --name "test description"

# 测试并发运行
flutter test --concurrency=4

# 持续测试（监视文件变化）
flutter test --watch

🏗 构建命令

Android 构建

bash

复制代码

# 构建 APK
flutter build apk

# 构建特定 CPU 架构的 APK
flutter build apk --target-platform android-arm64

# 构建 App Bundle
flutter build appbundle

# 构建发布版本
flutter build apk --release

# 构建调试版本
flutter build apk --debug

# 构建 Profile 版本
flutter build apk --profile

# 构建并指定 flavor
flutter build apk --flavor prod

iOS 构建

bash

复制代码

# 构建 iOS
flutter build ios

# 构建 iOS 发布版本
flutter build ios --release

# 构建 iOS 模拟器版本
flutter build ios --simulator

# 清理 iOS 构建
flutter build ios --clean

# 构建并指定配置
flutter build ios --flavor dev

Web 构建

bash

复制代码

# 构建 Web 版本
flutter build web

# 构建 Web 发布版本
flutter build web --release

# 指定 Web 渲染器
flutter build web --web-renderer html
flutter build web --web-renderer canvaskit
flutter build web --web-renderer auto

# 设置基本路径
flutter build web --base-href /myapp/

其他平台

bash

复制代码

# 构建 Windows 应用
flutter build windows

# 构建 macOS 应用
flutter build macos

# 构建 Linux 应用
flutter build linux

📦 包管理命令

依赖管理

bash

复制代码

# 获取依赖（类似 Android 的 sync）
flutter pub get

# 升级依赖
flutter pub upgrade

# 升级到最新版本
flutter pub upgrade --major-versions

# 添加依赖
flutter pub add <package_name>
flutter pub add http
flutter pub add provider

# 添加开发依赖
flutter pub add --dev flutter_test

# 删除依赖
flutter pub remove <package_name>

# 列出过时的包
flutter pub outdated

# 依赖检查
flutter pub deps

# 获取依赖但不更新
flutter pub get --offline

包发布

bash

复制代码

# 检查包是否可发布
flutter pub publish --dry-run

# 发布包
flutter pub publish

# 撤销发布
flutter pub publish --retract <version>

🧹 清理与维护

清理命令

bash

复制代码

# 清理构建文件
flutter clean

# 清理并重新获取依赖
flutter clean && flutter pub get

# 清理更彻底
flutter clean && rm -rf pubspec.lock && flutter pub get

# 重置 Flutter 状态
flutter precache --force

缓存管理

bash

复制代码

# 清理构建缓存
flutter build clean

# 查看缓存大小
flutter cache --help

# 清理所有缓存
flutter cache clean

# 修复缓存
flutter cache repair

🔍 诊断与修复

环境检查

bash

复制代码

# 检查开发环境
flutter doctor

# 详细检查
flutter doctor -v

# 仅检查特定平台
flutter doctor --android-licenses

# 运行 doctor 并自动修复
flutter doctor --android-licenses

版本管理

bash

复制代码

# 查看 Flutter 版本
flutter --version

# 查看渠道信息
flutter channel

# 切换渠道
flutter channel stable
flutter channel beta
flutter channel dev
flutter channel master

# 更新 Flutter
flutter upgrade

# 强制更新
flutter upgrade --force

# 查看更新日志
flutter downgrade

🚀 性能与优化

性能分析

bash

复制代码

# 分析应用启动
flutter run --trace-startup --profile

# 生成性能跟踪文件
flutter run --trace-skia

# 分析渲染性能
flutter run --profile --trace-skia

# 内存分析
flutter run --observatory-port=8888

包大小分析

bash

复制代码

# 分析 APK 大小
flutter build apk --analyze-size

# 分析 App Bundle 大小
flutter build appbundle --analyze-size

# 详细分析
flutter build apk --target-platform android-arm64 --analyze-size

📊 信息与报告

生成报告

bash

复制代码

# 生成打包报告
flutter build apk --verbose

# 生成符号表
flutter build apk --split-debug-info=./debug-info/

# 生成崩溃符号化文件
flutter build apk --obfuscate --split-debug-info=./debug-info/

项目信息

bash

复制代码

# 显示项目信息
flutter config

# 显示构建配置
flutter build apk --help

# 查看已安装的插件
flutter pub global list

# 显示包信息
flutter pub deps --style=compact

🛠 高级命令

自定义构建

bash

复制代码

# 指定目标文件
flutter run -t lib/main_development.dart

# 指定构建名称和版本
flutter build apk --build-name=1.0.0 --build-number=1

# 启用实验性功能
flutter run --enable-experiment=non-nullable

插件开发

bash

复制代码

# 生成插件模板
flutter create --template=plugin --platforms=android,ios hello

# 运行插件示例
cd example && flutter run

# 生成原生代码
flutter pub run build_runner build

📚 实用别名（添加到 ~/.bashrc 或 ~/.zshrc）

bash

复制代码

# Flutter 常用命令别名
alias f='flutter'
alias fr='flutter run'
alias fg='flutter pub get'
alias fu='flutter pub upgrade'
alias fc='flutter clean'
alias ft='flutter test'
alias fa='flutter analyze'
alias ff='flutter format .'
alias fd='flutter devices'
alias fdoc='flutter doctor'
alias fbuild='flutter build'
alias fbuilda='flutter build apk'
alias fbuildi='flutter build ios'
alias fbuildw='flutter build web'

🎯 常用工作流组合

日常开发流程

bash

复制代码

# 1. 检查设备
flutter devices

# 2. 清理并获取依赖
flutter clean && flutter pub get

# 3. 运行应用
flutter run -d <device_id>

# 4. 开发中热重载
# 在终端按 'r' 键

发布前准备

bash

复制代码

# 1. 运行测试
flutter test

# 2. 代码分析
flutter analyze

# 3. 代码格式化
flutter format .

# 4. 构建发布包
flutter build appbundle --release
# 或
flutter build ios --release

问题排查流程

bash

复制代码

# 1. 检查环境
flutter doctor

# 2. 清理项目
flutter clean

# 3. 更新依赖
flutter pub upgrade

# 4. 重新运行
flutter run --verbose

💡 实用技巧

快速查看命令帮助

bash

复制代码

# 查看所有命令
flutter --help

# 查看特定命令帮助
flutter <command> --help
flutter run --help
flutter build --help

# 查看版本信息
flutter --version -v

批量操作

bash

复制代码

# 同时构建多个平台
flutter build apk && flutter build appbundle

# 清理所有平台的构建
rm -rf build/ ios/Pods ios/.symlinks

Web 特定命令

bash

复制代码

# 本地 Web 服务器
flutter run -d chrome --web-hostname localhost --web-port 5000

# 构建优化版本
flutter build web --tree-shake-icons --source-maps

end！！！