flutter devices返回空需先运行adb devices确认设备online，再执行flutter devices看到有效设备条目；F5调试需设备已选、项目根目录打开、launch.json标准；热重载仅在F5调试态生效，不支持main()或initState()等修改。
flutter devices 返回空，但模拟器明明开着
这是最常卡住的第一步。VSCode 不会主动拉起模拟器，也不会自动重试识别——它只读取 flutter devices 的当前输出。
哪怕你刚点开 Android Studio 的 AVD Manager 并启动了 Pixel_4_API_33，也要等几秒让 ADB 注册设备，再手动刷新。
- 先在终端运行
adb devices，确认输出里有类似emulator-5554 device的行 - 如果显示
offline，执行adb kill-server && adb start-server再运行flutter devices - 必须看到带
emulator或具体设备名（如Pixel_4a_API_33）的条目才算成功
F5 启动没反应，或报 “No device selected”
F5 启动的是完整调试会话，不是简单运行。它依赖三个前提同时满足：设备已选中、项目根目录打开、launch.json 配置正确。漏掉任一环都会静默失败或报错。
- 确保 VSCode 当前打开的是项目根目录（含
pubspec.yaml和lib/main.dart），不是子文件夹 - 首次按 F5 时，VSCode 会自动生成
.vscode/launch.json，内容应为标准 Dart 类型配置，无需手动改deviceID字段 - 如果已生成
launch.json却仍失败，检查里面是否有硬编码的deviceId；填错（比如复制了adb devices输出里的offline行）会导致启动中断 - 右下角状态栏必须显示设备名 + 虫子图标（⚡️Debug），才是真调试态；仅显示设备名但没虫子，说明是
flutter run模式，不支持断点
热重载（Ctrl+S）不生效，UI 完全没变
热重载不是万能的，它只替换 widget 树中可重建的部分。一旦修改涉及顶层结构、状态初始化或平台通道，就会退化为“热重启无效”，必须手动触发全量重建。
- 保存后看 VSCode 底部托盘是否闪现 “Hot reload was performed” 提示；没提示 = 根本没触发
- 确认你是在调试模式（F5）下运行，而不是点右上角绿色 ▶️ 按钮（那是
flutter run） - 修改
main()函数、MaterialApp构造参数、或initState()中的逻辑，热重载会跳过——此时需用Ctrl+Shift+F5热重启 - 若连热重启都不生效，检查
dart.flutterSdkPath是否指向 Flutter 根目录（如/Users/alex/flutter），而非bin子目录；Windows 用户注意用双反斜杠
模拟器启动慢、热重载延迟高
AVD 默认配置在多数开发场景下性能偏低，尤其冷启动和热重载响应时间容易拖慢节奏。
- 优先选用 x86_64 镜像（非 ARM），并启用 Host GPU 渲染；在 AVD 创建时勾选 “Use Host GPU”
- 避免使用 API 34+ 的最新系统镜像（实测冷启动 >60 秒），推荐 API 33（Android 13）或 API 30（Android 11）
- 命令行启动更可控：
emulator -avd Pixel_4_API_33 -no-window -no-audio，减少 GUI 开销 - Genymotion 在热重载响应上表现更优（
真正卡住的往往不是代码本身，而是设备注册延迟、SDK 路径错位、或误把 flutter run 当成调试入口——这些细节不显眼，但每一条都足以让热重载彻底失效。
