flutter devices返回空需先运行adb devices确认设备在线，若offline则执行adb kill-server && adb start-server，再运行flutter devices确保显示emulator或设备名，最后在VSCode中手动选择设备并以F5调试模式启动。
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）的条目才算成功 - VSCode 底部状态栏点击设备名 → 从弹出列表选中它；若列表为空，按
Ctrl+Shift+P输入Flutter: Select Device强制刷新 - 别依赖 Android Studio 界面启动模拟器后切回 VSCode —— 改用命令行：
emulator -avd Pixel_4_API_33 -no-window -no-audio，更稳定
按 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.flutterHotReloadOnSave是否设为true（在 VSCode 设置 JSON 中加这一行）
模拟器卡顿、黑屏或启动失败
模拟器性能问题几乎都和硬件加速或 SDK 版本错配有关，和 VSCode 本身无关。Flutter 插件只是调用底层工具链，瓶颈在系统级配置。
- Windows 用户务必启用 Windows Hypervisor Platform（WHPX），禁用 Hyper-V；macOS 用户检查是否装了 Intel HAXM 或 Apple Silicon 原生模拟器支持
- 避免混用 Android Studio 自带模拟器和命令行
emulator工具——统一用 SDK 下的emulator，路径通常为~/Library/Android/sdk/emulator（macOS）或%ANDROID_HOME%\emulator（Windows） - 创建 AVD 时，选择与宿主机 CPU 匹配的系统镜像：x86_64 镜像配 Intel/AMD CPU，arm64 镜像配 Apple Silicon Mac；错配会导致无限黑屏
- 首次启动某 AVD 后，
flutter emulators --launch可复用已有实例，比每次重新开更快
adb devices 和 flutter devices 的输出是否真正对齐。 
