Flutter 常用命令：run、analyze 完全指南

Flutter 开发中常用的命令行工具，包括运行、调试、分析等命令。

flutter run

启动 Flutter 应用，支持热重载（Hot Reload）和热重启（Hot Restart）。

bash

flutter run

启动后，终端里按：

按键	功能
`r`	Hot Reload（热重载，保留状态）
`R`	Hot Restart（热重启，重新初始化）
`q`	退出

指定设备启动

bash

# 查看连接的设备
flutter devices

# 指定设备
flutter run -d <device_id>

# 常用设备简写
flutter run -d chrome        # Web
flutter run -d macos         # macOS
flutter run -d emulator-5554 # Android 模拟器
flutter run -d ios           # iOS 模拟器

运行模式

bash

flutter run --debug     # debug 模式（默认，支持热重载）
flutter run --profile   # profile 模式（性能分析）
flutter run --release   # release 模式（不支持热重载）

flutter analyze

静态代码分析，检查代码中的错误、警告和代码风格问题，不需要运行应用。

bash

flutter analyze

常用参数

bash

flutter analyze --no-fatal-warnings   # 警告不算作失败（CI 常用）
flutter analyze --no-fatal-infos      # info 级别不算失败
flutter analyze lib/                  # 只分析指定目录

配置分析规则

在项目根目录的 analysis_options.yaml 里配置：

yaml

include: package:flutter_lints/flutter.yaml

linter:
  rules:
    prefer_const_constructors: true
    avoid_print: true
    # 关闭某条规则
    use_key_in_widget_constructors: false

analyzer:
  errors:
    # 把某个警告降级为 info
    dead_code: info
    # 忽略某个规则
    invalid_annotation_target: ignore

常用 lint 包

flutter_lints：Flutter 官方推荐，默认集成
very_good_analysis：更严格的规则集
lint：社区维护的规则集

CI 中使用

bash

flutter analyze --no-fatal-warnings && echo "分析通过"

一般和 flutter test 一起跑，作为 PR 检查的基础门槛。

其他常用命令

命令	说明
`flutter doctor`	检查开发环境配置
`flutter pub get`	获取依赖
`flutter pub upgrade`	升级依赖
`flutter build apk`	构建 Android APK
`flutter build ios`	构建 iOS 应用
`flutter test`	运行测试
`flutter clean`	清理构建缓存

总结

日常开发最常用的三个命令：

bash

flutter run -d <device>    # 运行调试
flutter analyze           # 代码分析
flutter test              # 运行测试

掌握这些命令，可以覆盖大部分 Flutter 开发场景。

字节笔记本

Flutter 常用命令：run、analyze 完全指南

flutter run

指定设备启动

运行模式

flutter analyze

常用参数

配置分析规则

常用 lint 包

CI 中使用

其他常用命令

总结