VSCode开发Flutter必须只装Dart Code和Flutter两个官方插件并手动配置dart.flutterSdkPath路径，否则将出现断点失效、无代码补全、F5报“No debug adapter found”等高频问题；路径须指向Flutter根目录（含bin/flutter），且需通过Flutter: Reload Window生效。
VSCode 本身不带 Flutter 支持，装对插件 + 手动填 SDK 路径是唯一可靠路径；否则你会遇到断点不生效、代码无补全、F5 启动报 “No debug adapter found” —— 这三类问题占新手卡顿的 90% 以上。
只装 Dart Code 和 Flutter 两个官方插件
VS Code 扩展市场搜 “Dart” 或 “Flutter”，会出来一堆非官方插件（比如旧版 Dart 单独插件、Flutter Snippets、Quick Flutter），它们和当前 Flutter 版本（如 v3.19.x）不兼容，会导致：
-
Cannot resolve a concrete Dart SDK错误 - 右键菜单里没有
Run 'main.dart' - 按 F5 启动时提示
No debug adapter found for flutter
正确做法：
- 卸载所有 Dart/Flutter 相关插件
- 仅安装
Dart Code（作者：Dart-Code.dart-code） - 再安装
Flutter（作者同上，它会自动启用Dart Code） - 重启 VS Code，打开任意
.dart文件，状态栏右下角应显示类似Dart: v3.6.x和Flutter: v3.19.x
dart.flutterSdkPath 必须手动设为 Flutter 根目录
VS Code 不依赖系统 PATH 查找 Flutter，也不信任自动检测结果。哪怕你在终端能跑 flutter --version，只要 dart.flutterSdkPath 没配对，热重载、设备列表、调试器都会失效。
配置方式：
- 打开设置（
Ctrl+,或Cmd+,），搜索dart.flutterSdkPath - 点击 “在 settings.json 中编辑”，添加一行（路径必须是解压后的根目录，不是
bin子目录）：
"dart.flutterSdkPath": "/Users/you/flutter"
（macOS/Linux）或
"dart.flutterSdkPath": "C:\src\flutter"
（Windows，注意双反斜杠）
- 确认该路径下存在
bin/flutter（macOS/Linux）或bin/flutter.bat（Windows） - 改完后按
Ctrl+Shift+P输入Flutter: Reload Window生效
F5 调试失败？先验证这三件事，别只信 flutter doctor
flutter doctor -v 只检查命令行环境是否就位，但 VS Code 插件可能完全读不到这些路径。真正有效的验证必须实操：
- 新建项目：
flutter create myapp && code myapp，等右下角出现设备选择器（如Chrome (web-javascript)或iPhone 15 (iOS)） - 按 F5 启动调试 —— 注意不是在终端运行
flutter run，而是用 VS Code 自带的调试器；成功后左上角应出现调试控制栏 - 在
main.dart的build()方法第一行打个断点，触发热重载或刷新页面，确认能停住且变量可查看
任一环节失败，问题大概率出在插件未启用、SDK 路径错误，或 VS Code 是从 Dock/开始菜单启动（丢失 shell 环境变量）—— macOS 用户请用终端执行 code --new-window 启动，Windows 用户请确保系统级 PATH 包含 flutterin。
真机调试连不上？关键在证书信任和设备管理
iOS 真机调试卡在 Installing and launching... 或报 Could not find the built application bundle，通常不是 Flutter 问题，而是 Xcode 工具链、证书或设备信任链中断：
- 手机连接电脑后，进入 iPhone 设置 →
通用 → 设备管理（或描述文件与设备管理），手动信任你的开发者证书 - VS Code 中运行时设备必须选
iPhone (your device name)，不能选 Chrome 或模拟器 - 确保 Xcode 命令行工具已安装：
xcode-select --install，且已登录 Apple ID（Xcode → Preferences → Accounts） - 如果用 Android 真机，确认
adb devices能列出设备，且 USB 调试已开启
VS Code 内部不输出详细构建日志，这类问题一旦卡住，直接切到终端执行 flutter run -v 才能看到真实错误源头 —— 很多时候是证书没信任、描述文件过期，或者 Xcode 自动签名失败，但 VS Code 只静默卡住。
