vscode中flutter调试需手动配置dart.fluttersdkpath绝对路径、安装dart与flutter双插件、显式选择设备并用f5启动调试，缺一不可。
Flutter 命令必须在 VSCode 内部可达
VSCode 不会自动继承系统 PATH 中的 flutter 命令，即使终端里 flutter --version 能跑通，VSCode 插件也可能完全失联。最直接的表现是：右下角不显示设备名、F5 无反应、Ctrl+Shift+P 输入 Flutter: Run Flutter Doctor 报 “command not found”。
- 打开 VSCode 设置（
Cmd+,或Ctrl+,），搜索dart.flutterSdkPath - 点击 “Edit in settings.json”，填入 SDK 根目录的绝对路径（不是
bin/子目录）："dart.flutterSdkPath": "/Users/yourname/development/flutter"（macOS/Linux）"dart.flutterSdkPath": "C:\src\flutter"（Windows，注意双反斜杠） - 保存后，按
Cmd+Shift+P运行Flutter: Run Flutter Doctor，输出应与终端一致；若仍报错，检查路径是否含中文、空格或符号链接
必须同时安装 Dart 和 Flutter 两个插件
只装 Dart 插件，VSCode 就是个语法高亮器——没有设备列表、没有热重载按钮、F5 启动调试直接失败。真正驱动设备检测、flutter run 调用、断点调试的是 Flutter 插件，它依赖 Dart 但不被其替代。
- 扩展市场中搜索
Dart，认准发布者为Dart-Code.dart-code，安装后关闭所有 VSCode 窗口，从系统启动器重新打开 - 再搜索
Flutter，同样认准Dart-Code.dart-code，安装后再次完全重启 VSCode - 打开任意
.dart文件，确认状态栏右下角出现类似Dart SDK 3.6.x和Flutter 3.19.x的字样 - 如果右下角始终显示
No device selected，先按Ctrl+Shift+P执行Flutter: Select Device强制刷新设备列表
真机调试前必须满足三个硬性条件
缺一不可：adb 可用、手机已授权、VSCode 显式选中设备。漏掉任一个，F5 按下去就静音——不报错、不弹窗、不启动。
- 终端运行
adb version，有版本号输出才说明adb在 PATH 里；Windows 用户注意系统级环境变量也要加，某些 VSCode 启动方式忽略用户级 PATH - 运行
adb devices，输出中必须有一行状态为device（不是offline或空行）；插线后手机弹出“允许 USB 调试吗？”，必须点“允许”并勾选“始终允许” - 国产机额外注意：
USB 调试(安全设置)（小米）、关闭 MIUI 优化（部分小米）、允许通过 USB 安装应用（vivo/OPPO）这三项常卡住连接 - VSCode 底部状态栏右下角必须手动点击设备名（如
SM-G998U），哪怕只连一台手机也不会自动选；菜单为空时，先执行Flutter: Select Device
F5 和绿色 ▶️ 按钮行为完全不同
右上角绿色三角形按钮默认执行 flutter run，它不挂调试器、不监听断点、热重载（Ctrl+S）也无效。只有 F5 才真正进入调试态，支持断点、变量查看、调用栈和完整热重载通道。
- 确保项目根目录下有
lib/main.dart，且当前打开的编辑器标签页是它 - 不要在
launch.json中硬编码deviceId字段——填错（比如复制了adb devices输出里的offline行）会导致Failed to launch browser这类误导性错误 - 首次调试成功后，左上角会出现调试控制栏（继续、暂停、重启、停止），热重载按钮也会激活；若没出现，说明调试进程根本没起来，回退检查前三步
F5 能启动、热重载可触发，不代表真机通信链路就稳了——USB 连接松动、MIUI 后台策略杀进程、开发者选项被系统重置，都可能让调试中途断开。每次换线、重启手机或升级系统后，都要重新验证 adb devices 和 VSCode 设备选择状态。
