VSCode无法调试Flutter移动端应用，90%因dart.flutterSdkPath路径错误、Dart与Flutter插件未同时安装或未彻底重启；该路径须为Flutter根目录绝对路径（不含bin），且必须从系统启动器重启VS Code，否则插件链不加载、F5失效。
VSCode 无法调试 Flutter 移动端应用，90% 是因为 dart.flutterSdkPath 没填对、两个插件没装全、或者没彻底重启——不是环境变量问题，也不是 Flutter SDK 本身坏了。
dart.flutterSdkPath 必须手动填绝对路径，且不能带 bin/
VS Code 插件从不读系统 PATH，也不解析 shell 配置。即使终端里 flutter --version 成功，GUI 启动的 VS Code 进程也完全看不到它。
- 打开设置（
Cmd+,或Ctrl+,），搜索dart.flutterSdkPath - 点击 “Edit in settings.json”，填入 Flutter SDK 根目录的绝对路径：
macOS/Linux 示例："dart.flutterSdkPath": "/Users/yourname/development/flutter"
Windows 示例："dart.flutterSdkPath": "C:\src\flutter"（注意双反斜杠） - 路径下必须存在
bin/flutter（macOS/Linux）或bin/flutter.bat（Windows） - 填错最常见表现：
Flutter: Run Flutter Doctor报 command not found，或右下角始终显示No device selected
必须同时安装 Dart 和 Flutter 两个官方插件，并彻底重启
只装 Dart 插件，VS Code 就是个语法高亮器；只装 Flutter 插件但没装 Dart，会直接报 No debug adapter found。
- 在扩展市场搜索
Dart，认准发布者为Dart-Code.dart-code，安装后关闭所有 VS Code 窗口 - 再搜索
Flutter，同样认准Dart-Code.dart-code，安装后再次**从系统启动器（Launchpad / 开始菜单）重新打开**，不是用快捷方式或Developer: Reload Window - 打开任意
.dart文件，确认状态栏右下角出现类似Dart SDK 3.6.x和Flutter 3.19.x的字样 - 如果热重载按钮灰色、F5 无反应、右键没有
Run 'main.dart'，说明插件链没加载成功
真机调试前必须满足三个硬性条件：adb 可用、手机已授权、VSCode 显式选中设备
F5 按下去没反应，不是代码问题，是链路断在了底层。VS Code 不直接连手机，它靠 flutter run 调用 adb 查设备，缺一不可。
- 终端执行
adb version，有输出才说明adb在 PATH 里；Windows 用户要检查系统级环境变量，某些启动方式忽略用户级 PATH - 执行
adb devices，输出中必须有一行状态为device（不是offline或空行） - 手机插线后弹出“允许 USB 调试吗？”，必须点“允许”并勾选“始终允许”；国产机额外注意：
USB 调试(安全设置)（小米）、关闭 MIUI 优化（部分小米）、允许通过 USB 安装应用（vivo/OPPO） - VS Code 底部状态栏右下角必须手动点击设备名（如
SM-G998U），哪怕只连一台也不会自动选；菜单为空时先执行Flutter: Select Device
F5 和绿色 ▶️ 按钮行为完全不同
右上角绿色三角形按钮默认执行 flutter run，它不挂调试器，断点不会命中，热重载也不走调试通道。
- 只有按
F5（或Run > Start Debugging）才会启动完整调试会话，支持断点、变量监视、热重载（R）、热重启（Shift+R） - 项目必须在含
pubspec.yaml的根目录下打开，否则 F5 可能找不到 launch config -
launch.json里不要硬写deviceId，除非你在 CI 场景固定某台设备；填错（比如复制了adb devices输出里的offline行）会导致Failed to launch browser这类误导性错误
最容易被忽略的是：VS Code 启动方式和插件加载时机。从 Dock 或任务栏快捷方式打开，常常继承不到正确的环境变量，也触发不了插件重初始化。每次改完 settings.json 或装完插件，都得关干净、从系统入口重开——这点比路径写对还关键。
