以下是 Flutter 项目开发中常用的命令，涵盖项目创建、运行、调试、构建、依赖管理等核心操作，适用于 macOS/Windows/Linux 平台：
1. 项目创建与初始化
| 命令 |
说明 |
flutter create <项目名> |
创建一个新的 Flutter 项目 |
flutter create --org com.example <项目名> |
指定包名（Android 的 applicationId 和 iOS 的 Bundle ID） |
flutter create --platforms android,ios,web <项目名> |
创建时指定支持的平台（默认全平台） |
flutter pub get |
获取/更新项目的所有依赖（等同于 npm install） |
2. 运行与热重载
| 命令 |
说明 |
flutter run |
运行项目（自动检测连接的设备） |
flutter run -d <设备ID> |
指定设备运行（通过 flutter devices 查看设备ID） |
flutter run --release |
以发布模式运行（关闭调试功能） |
flutter run --profile |
以性能分析模式运行 |
flutter run --debug |
以调试模式运行（默认） |
r |
在运行界面按 r 触发热重载（Hot Reload） |
R |
在运行界面按 R 触发热重启（Hot Restart） |
3. 设备管理
| 命令 |
说明 |
flutter devices |
查看所有可用设备（真机/模拟器） |
flutter emulators |
查看已安装的模拟器 |
flutter emulators --launch <模拟器名> |
启动指定模拟器（如 Pixel_5_API_33） |
flutter doctor |
检查开发环境配置是否完整 |
4. 调试与日志
| 命令 |
说明 |
flutter debug |
启动调试模式（集成 IDE 调试） |
flutter logs |
查看设备日志（需连接设备） |
flutter attach |
附加到正在运行的 Flutter 应用（用于调试） |
flutter inspect |
检查 Widget 树（需配合 DevTools 使用） |
5. 依赖管理
| 命令 |
说明 |
flutter pub add <包名> |
添加依赖（如 flutter pub add http） |
flutter pub remove <包名> |
移除依赖 |
flutter pub upgrade |
升级所有依赖到最新版本 |
flutter pub outdated |
检查过时的依赖 |
flutter pub get --offline |
离线模式下获取依赖（使用本地缓存） |
6. 构建与发布
| 命令 |
说明 |
flutter build apk |
构建 Android APK（默认调试版） |
flutter build apk --release |
构建 Android 发布版 APK |
flutter build appbundle |
构建 Android App Bundle（AAB） |
flutter build ios |
构建 iOS 应用（需 Xcode） |
flutter build ios --release --no-codesign |
构建 iOS 发布版（不签名） |
flutter build web |
构建 Web 应用（输出到 build/web） |
flutter install |
安装构建好的应用到设备 |
7. 测试与质量检查
| 命令 |
说明 |
flutter test |
运行项目中的所有单元测试 |
flutter test integration_test |
运行集成测试 |
flutter analyze |
静态代码分析（检查潜在问题） |
flutter format . |
格式化所有 Dart 代码 |
flutter pub run dart_code_metrics:metrics analyze lib |
使用 dart_code_metrics 检查代码质量 |
8. 平台相关操作
| 命令 |
说明 |
flutter clean |
清理构建缓存（解决一些编译问题） |
flutter precache |
预下载所需的二进制文件（如引擎、工具链） |
flutter config --enable-web |
启用 Web 支持 |
flutter config --no-enable-android |
禁用 Android 平台支持 |
9. 升级与版本管理
| 命令 |
说明 |
flutter upgrade |
升级 Flutter SDK 到最新稳定版 |
flutter downgrade <版本号> |
降级 Flutter SDK |
flutter channel stable |
切换到稳定版通道（其他选项：beta/dev/master） |
flutter --version |
查看当前 Flutter 和 Dart 版本 |
10. 其他实用命令
| 命令 |
说明 |
flutter gen-l10n |
生成国际化（i18n）文件 |
flutter pub global activate <包名> |
全局激活 Dart/Flutter 工具（如 webdev） |
flutter symbolize -i <崩溃日志> -d <设备ID> |
符号化崩溃日志（用于分析 Native 层错误） |
常见场景示例
从零启动一个 Flutter 项目
flutter create my_app
cd my_app
flutter pub add http provider # 添加常用依赖
flutter run -d iPhone # 运行到 iOS 模拟器
构建发布版 APK 并安装到设备
flutter build apk --release
flutter install build/app/outputs/flutter-apk/app-release.apk
检查代码质量并格式化
flutter analyze
flutter format .
掌握这些命令后，你可以高效完成 Flutter 项目的开发、调试和发布全流程！如果有特定需求（如 Firebase 集成），可结合对应插件的命令行工具（如 flutterfire configure）。
