必须手动配置dart.flutterSdkPath、只装Dart Code和Flutter两个官方插件并彻底重启VS Code，否则90%会出现断点不命中、设备列表为空、F5报No debug adapter found；插件不读系统PATH，仅依赖手动设置的绝对路径和正确重启。
没有“全量自动化配置”这回事——VSCode 的 Flutter 环境必须手动配 dart.flutterSdkPath、必须装对两个插件、必须重启进程，任何脚本或一键安装器绕过这三步，90% 会卡在断点不命中、设备列表为空、F5 报 No debug adapter found。
为什么不能靠脚本自动配好 dart.flutterSdkPath
VS Code 插件从不读取系统 PATH，也不解析 shell 配置（比如 ~/.zshrc 中的 export PATH=...）。哪怕你在终端敲 flutter --version 成功，GUI 启动的 VS Code 进程默认看不到它。
插件只认两个来源：
• 系统环境变量（Windows Path / macOS/Linux PATH），且仅限于 VS Code 启动时继承的那一份
• 手动填进 settings.json 的 dart.flutterSdkPath
而后者才是唯一稳定、可验证、插件真正依赖的路径。所有所谓“自动探测 SDK”的插件功能，实际是 fallback 到 PATH 查找，失败率极高。
必须只装 Dart Code 和 Flutter 两个插件，顺序不能错
装错插件是新手最常踩的坑，不是功能少，而是冲突：
• 卸载所有名字含 “Flutter Snippets”、“Quick Flutter”、“Dart Extension”（旧版独立 Dart 插件）等非官方扩展
• 先装 Dart Code（发布者：Dart-Code.dart-code）
• 再装 Flutter（同发布者，它会自动启用 Dart Code，但反过来不行）
• 每次安装后，关掉**所有** VS Code 窗口，从系统启动器（macOS Launchpad / Windows 开始菜单）重新打开——Developer: Reload Window 不触发插件重初始化
没走完这步，状态栏右下角不会显示 Flutter: v3.x.x，F5 必报错
验证是否真生效，别信 flutter doctor -v
flutter doctor -v 全绿只说明命令行环境 OK，不代表 VS Code 能调用它。实操验证必须做这三件事：
• 终端执行 flutter create myapp && code myapp（注意：必须在项目根目录打开 VS Code，即含 pubspec.yaml 的那层）
• 等右下角状态栏出现设备选择器（如 Chrome (web-javascript) 或 iPhone 15 (iOS)）
• 按 F5 启动调试（不是终端跑 flutter run），成功后左上角弹出调试控制栏
• 在 lib/main.dart 的 build() 第一行打个断点，确认能命中
漏掉任意一步，就说明插件没真正加载 SDK，回头检查 dart.flutterSdkPath 路径是否指向含 bin/flutter 的根目录（不是 bin 子目录）
launch.json 和热重载容易被忽略的细节
即使环境配对，F5 启动后断点不触发，大概率是调试配置不对：
• 确保 .vscode/launch.json 中 request 字段为 "launch"，type 为 "dart"
• 首次 F5 没生成 launch.json？按 Ctrl+Shift+P 输入 Debug: Open launch.json，选 Dart & Flutter 模板
• 热重载快捷键是 Ctrl+F5（Windows/Linux）或 Cmd+Shift+R（macOS），但改了 main() 外的顶层变量或 initState 逻辑，必须用热重启（Ctrl+Shift+F5）
• args 字段加 --verbose 可定位构建卡顿，但仅限调试时临时启用，别留着
最麻烦的从来不是装什么，而是 VS Code 进程没真正继承环境、插件没重载、路径多写一个 /bin——这些点都得人眼确认，没法全自动。
