Flutter 真机调试命令 - 字节笔记本

[!info] 设备信息 示例设备: V2505A 设备 ID: 10AFAC3AJC003C1 系统: Android 16 (API 36) 架构: android-arm64

本文介绍 Flutter 真机调试的完整流程，包括查看已连接设备、指定设备运行、常用参数、热重载操作和常见设备连接问题的解决方法。

调试流程

1. 查看已连接设备

bash

flutter devices

输出示例:

text

Found 4 connected devices:
  V2505A (mobile) • 10AFAC3AJC003C1 • android-arm64 • Android 16 (API 36)
  macOS (desktop) • macos            • darwin-arm64   • macOS 15.2
  Chrome (web)    • chrome           • web-javascript • Google Chrome
  Edge (web)      • edge             • web-javascript • Microsoft Edge

2. 停止当前运行

bash

pkill -f "flutter run"

[!tip] 提示如果之前有应用在模拟器或其他设备上运行，需要先停止

3. 在指定设备上运行

bash

flutter run -d <设备ID>

示例我的vivo真机：

bash

flutter run -d 10AFAC3AJC003C1

常用参数

参数	说明
`-d <设备ID>`	指定目标设备
`--release`	以 release 模式运行
`--profile`	以 profile 模式运行
`--verbose`	显示详细输出

快捷操作

热重载

应用运行时，在终端按：

快捷键	功能
`r`	热重载
`R`	热重启
`h`	帮助
`q`	退出

查看日志

bash

flutter logs

查看特定设备日志：

bash

flutter logs -d <设备ID>

注意事项

[!warning] 重要提示

- 确保设备已开启 USB 调试模式
- 首次连接需要在手机上确认授权
- 确保电脑和设备在同一网络（如使用无线调试）
- release 模式性能更接近生产环境

设备连接问题

设备未显示

bash

# 检查 ADB 连接
adb devices

# 重启 ADB 服务
adb kill-server
adb start-server

授权问题

在手机上：

设置 → 关于手机 → 连续点击"版本号"7次开启开发者模式
设置 → 开发者选项 → 开启"USB调试"
连接电脑后，在弹出窗口中点击"允许"