能调试需满足三个条件：adb可用、真机已授权、vscode选中设备；缺一则f5无响应。adb version有输出说明路径正确，adb devices显示device且手机勾选“始终允许”，vscode须手动选择设备才能启动调试。
能跑起来，但必须满足三个硬性条件：adb 可用、真机已授权、VSCode 选中了设备。漏掉任意一个，F5 按下去就静音——既不报错也不启动。
adb version 能跑通，才是真连上了
VSCode 不直接和手机通信，它靠 flutter run 调用 adb 找设备。所以第一步永远是终端里敲：
-
adb version有版本号输出（比如Android Debug Bridge version 1.0.41），说明adb在 PATH 里 - 没反应或
command not found，就得补路径（通常是Android/sdk/platform-tools） - Windows 用户注意：别只改用户环境变量，系统变量也得加，某些 VSCode 启动方式会忽略用户级 PATH
- macOS/Linux 用户检查
~/.zshrc或~/.bash_profile是否执行了source，改完记得source ~/.zshrc
adb devices 显示 device，才算物理连接 OK
运行 adb devices，看到一行带 device 状态的输出（不是 offline 或空行），才算驱动和 USB 连接都到位。
- 真机要开两层开关：「开发者选项」+「USB 调试」是基础
- 国产机往往卡在第三层：
USB 调试(安全设置)（小米）、关闭 MIUI 优化（部分小米）、允许通过 USB 安装应用（vivo/OPPO） - 插上线后手机弹出“允许 USB 调试吗？”——必须点“允许”并勾选“始终允许”，只点一次下次重连还得再点
VSCode 底部状态栏不点设备名，F5 就是摆设
哪怕只连了一台手机，VSCode 也不会自动选它。你必须手动点右下角那个写着设备名（如 SM-G998U）或 No device selected 的区域，从弹出菜单里选中目标设备。
- 如果菜单里为空，但
adb devices能看见设备：按Ctrl+Shift+P唤出命令面板，输入并执行Flutter: Select Device强制刷新列表 - 如果仍为空，重启 VSCode 或执行
Developer: Reload Window -
launch.json里别写死deviceId字段——填错（比如复制了adb devices输出里的offline行）会导致Failed to launch browser这类误导性错误 - F5 启动才进调试态；右上角绿色 ▶️ 按钮默认执行
flutter run，它不挂调试器、不支持断点
dart.flutterSdkPath 必须手动填绝对路径
VS Code 不继承系统 PATH，也不会自动探测 SDK 位置。填错路径是导致“终端里 flutter doctor 全绿，但 VS Code 里啥都不行”的最常见原因。
- 打开设置（
Cmd+,或Ctrl+,），搜索dart.flutterSdkPath - 点击
Edit in settings.json，添加一行（注意结尾不加/bin）："dart.flutterSdkPath":"/Users/yourname/development/flutter" - Windows 用户注意反斜杠要双写：
"dart.flutterSdkPath":"C:\src\flutter" - 确保该路径下存在
bin/flutter（macOS/Linux）或bin/flutter.bat（Windows） - 保存后，按
Cmd+Shift+P运行Flutter: Run Flutter Doctor，输出应与终端一致
真机调试最常卡在“设备列表为空”或“F5 无响应”，问题几乎全出在 adb 权限链或 VSCode 插件路径识别上，而不是代码本身。每一步都要验证输出，别跳过 adb version 和 adb devices 这两个命令。
