1. 项目管理命令
| 命令 | 说明 |
|---|---|
flutter create <project_name> | 创建新 Flutter 项目，生成标准项目结构（包括 lib/main.dart 和 pubspec.yaml）。示例： flutter create my_app 创建名为 my_app 的项目。 |
flutter pub get | 获取 pubspec.yaml 中列出的依赖并下载到项目中。 |
flutter pub upgrade | 升级项目依赖到最新兼容版本。 |
flutter pub outdated | 检查依赖是否过时，列出可升级的包。 |
flutter pub add <package> | 将指定包添加到 pubspec.yaml 并运行 pub get。示例： flutter pub add http 添加 HTTP 包。 |
flutter pub remove <package> | 从 pubspec.yaml 中移除指定包并更新依赖。 |
2. 构建与运行命令
| 命令 | 说明 |
|---|---|
flutter run | 在连接的设备或模拟器上运行 Flutter 应用，支持热重载。 选项： - --debug：调试模式（默认）。- --release：发布模式（优化性能）。- --flavor <flavor>：指定构建变体。示例： flutter run --release。 |
flutter build <platform> | 构建指定平台的应用程序包。 子命令： - flutter build apk：生成 Android APK（调试模式）。- flutter build appbundle：生成 Android App Bundle（用于发布）。- flutter build ios：生成 iOS 应用（需 macOS）。- flutter build web：生成 Web 应用。选项： --release、--debug、--split-per-abi（生成按架构分割的 APK）。 |
flutter clean | 删除 build/ 目录和缓存，重置构建状态，用于解决构建问题。 |
3. 调试与分析命令
| 命令 | 说明 |
|---|---|
flutter analyze | 静态分析代码，检查潜在错误、代码风格问题（基于 analysis_options.yaml）。 |
flutter test | 运行项目中的单元测试、Widget 测试或集成测试。 示例： flutter test test/widget_test.dart 运行指定测试文件。 |
flutter logs | 显示连接设备或模拟器的日志输出，适用于调试运行中的应用。 |
flutter doctor | 检查 Flutter 开发环境，验证工具链（如 SDK、Android Studio、Xcode）是否正确配置。 |
flutter attach | 附加到正在运行的 Flutter 应用（通过 flutter run 或 IDE 启动），支持热重载调试。 |
4. 设备与模拟器管理
| 命令 | 说明 |
|---|---|
flutter devices | 列出所有连接的设备和模拟器，包括 ID 和状态。 |
flutter emulators | 列出可用的模拟器。 子命令： - flutter emulators --launch <emulator_id>：启动指定模拟器。示例： flutter emulators --launch Pixel_4_API_30。 |
flutter install | 将应用安装到连接的设备上（通常在 flutter run 后使用）。 |
5. 包与插件管理
| 命令 | 说明 |
|---|---|
flutter pub publish | 发布 Dart/Flutter 包到 pub.dev（需配置 pubspec.yaml 和账号）。 |
flutter pub cache repair | 修复本地包缓存，重新下载所有依赖。 |
flutter gen-l10n | 根据 l10n.yaml 生成本地化资源文件，用于国际化支持。 |
flutter pub run build_runner build | 使用 build_runner 生成代码（如 JSON 序列化、Freezed 类）。选项： --delete-conflicting-outputs 解决冲突。 |
6. 升级与版本管理
| 命令 | 说明 |
|---|---|
flutter upgrade | 升级 Flutter SDK 和依赖到最新版本。 |
flutter channel | 查看或切换 Flutter 渠道（如 stable、beta、dev）。示例： flutter channel beta 切换到 Beta 渠道。 |
flutter --version | 显示当前 Flutter SDK 版本和渠道信息。 |
7. 其他实用命令
| 命令 | 说明 |
|---|---|
flutter config | 配置 Flutter 全局设置，如启用 Web 支持或设置代理。 示例： flutter config --enable-web 启用 Web 平台支持。 |
flutter format <file/dir> | 格式化 Dart 文件，遵循 Dart 风格指南。 示例： flutter format lib/ 格式化 lib 目录下所有文件。 |
flutter doctor --android-licenses | 接受 Android SDK 许可（解决 flutter doctor 报告的许可问题）。 |
flutter analyze --watch | 持续监控代码变化并运行静态分析。 |
flutter precache | 预下载平台特定工具和资源（如 iOS 或 Android 工具链）。 |
注意事项
- 环境要求：运行命令前确保 Flutter SDK 已正确安装，环境变量配置正确（
flutter可在终端直接运行）。 - 选项与参数：大多数命令支持
--help查看详细用法，如flutter run --help。 - 上下文依赖：某些命令（如
flutter run、flutter build）需在 Flutter 项目目录中运行。 - 插件支持：部分命令（如
gen-l10n）依赖特定插件或配置，确保pubspec.yaml正确设置。
示例工作流
- 创建项目：
flutter create my_app - 获取依赖：
cd my_app && flutter pub get - 运行应用：
flutter run --debug - 构建发布包：
flutter build apk --release - 检查环境：
flutter doctor