90%的VSCode Flutter热重载失效、设备列表为空、F5卡在“Launching…”是因dart.flutterSdkPath配置错误；该路径必须精确指向Flutter根目录（含bin/flutter），而非bin子目录，且不读取系统PATH或终端环境变量。
VSCode 里 Flutter 热重载失效、设备列表为空、F5 启动卡在 “Launching…” —— 90% 是 dart.flutterSdkPath 配错了，而不是插件没装或系统 PATH 没设好。
dart.flutterSdkPath 必须指向 flutter 根目录，不是 bin 子目录
VSCode 的 Dart/Flutter 插件不读系统 PATH，也不自动继承终端里的环境变量。它只认 dart.flutterSdkPath 这个配置项，且路径必须精确到你解压/克隆的 flutter 文件夹本身。
- ✅ 正确示例（macOS/Linux）：
"dart.flutterSdkPath": "/Users/alex/flutter"—— 路径下有bin/flutter和packages/flutter_tools - ❌ 错误常见写法：
"dart.flutterSdkPath": "/Users/alex/flutter/bin"—— 插件会报 SDK not found，热重载按钮灰色，Flutter: Run Flutter Doctor命令消失 - ⚠️ Windows 用户注意反斜杠：必须用双反斜杠，如
"dart.flutterSdkPath": "C:\src\flutter"；单斜杠或正斜杠都会导致路径解析失败 - ? 验证方式：改完保存后，按
Ctrl+Shift+P输入Flutter: Run Flutter Doctor，输出应和终端里flutter doctor -v完全一致；若命令不可见或报错，说明配置未生效
热重载（Hot Reload）能用的前提是调试会话已启动
热重载不是编辑器功能，而是 Flutter 调试协议（DAP）的一部分。它只在 VSCode 通过调试器（而非终端 flutter run）启动应用后才激活。
- 必须先有有效的
.vscode/launch.json：首次按F5或点击运行面板绿色三角时，选择 “Dart & Flutter” 模板自动生成；确保program字段为"lib/main.dart" - 设备必须出现在右下角状态栏：显示 “Chrome (web-javascript)”、“iPhone 15” 或 “Android SDK built for x86_64” 才代表插件已识别设备；显示 “No Device” 时热重载不可用
- 快捷键因平台而异：
Ctrl+F5（Windows/Linux）、Cmd+Shift+R（macOS）；Ctrl+S保存不会自动触发，除非你额外启用了dart.saveBeforeRun - ⚠️ 修改
main()外部的顶层变量、initState逻辑、或新增 widget 类，热重载会失败并提示 “Error: Could not update files”，此时需热重启（Ctrl+Shift+F5）
Flutter 和 Dart 插件必须都装，且顺序不能反
只装 Dart 插件，VSCode 只能高亮语法、跳转定义；只装 Flutter 插件，它会因找不到 Dart 分析服务而报错退出。两者是强依赖关系，但安装时机影响加载状态。
- 先装
Dart（作者 Dart-Code），再装Flutter（同作者），每次安装后必须完全关闭所有 VSCode 窗口再重开 ——Developer: Reload Window不足以重建扩展间通信链路 - 装完后打开任意
.dart文件，右下角应显示语言模式为 “Dart”，且状态栏左端出现设备选择器；若只有 “Plain Text” 或无设备名，说明任一插件未激活 - 插件冲突风险：别装 “Flutter for VS Code”（已废弃）或第三方 Dart 插件，它们会覆盖官方 LSP 服务，导致断点不命中、补全延迟甚至分析服务器崩溃
最常被忽略的一点：即使 flutter doctor 全绿、VSCode 能跑热重载、断点也能停住，只要 dart.flutterSdkPath 指向的是旧版 SDK 目录，升级 Flutter 后就可能突然失效 —— 因为插件缓存了旧版工具链路径，不会自动刷新。每次 flutter upgrade 后，建议手动检查该配置是否仍指向当前正在用的 SDK 根目录。
