vscode运行flutter项目报错90%因flutter sdk路径未正确配置或插件安装错误；必须仅安装dart和flutter官方插件，dart.fluttersdkpath需指向含bin/flutter的根目录，并执行flutter: reload window验证。
VSCode 运行 Flutter 项目报错，90% 是因为 Flutter SDK 路径没配对，或插件装错 —— 不是代码问题，也不是网络问题，而是 VS Code 根本没找到 flutter 命令。
为什么 F5 启动报 “No debug adapter found for flutter”
这不是插件崩溃，而是 VS Code 插件压根没加载调试器。根本原因只有两个：dart.flutterSdkPath 没设，或设错了路径；或者装了非官方插件干扰了 Dart Code 的自动启用。
- 必须只装两个插件：
Dart（作者 Dart-Code.dart-code）和Flutter（同作者），卸载所有带 “Snippets”“Quick”“DevTools” 字样的第三方插件 -
dart.flutterSdkPath必须指向解压后的 Flutter 根目录（例如/Users/you/flutter），不是/bin子目录，且该路径下必须存在bin/flutter可执行文件 - 改完
settings.json后，必须手动执行Flutter: Reload Window（Cmd+Shift+P），光重启 VS Code 不生效 - 验证方式：打开
lib/main.dart，右下角状态栏应同时显示Dart SDK x.x.x和Flutter x.x.x，否则路径仍无效
flutter devices 返回空，但模拟器已启动
VS Code 设备列表为空，往往不是插件问题，而是 flutter devices 命令本身没输出设备 —— 它依赖 Xcode 工具链和模拟器运行时状态。
- 先在终端运行
flutter devices，如果返回空，说明 CLI 层就断了，VS Code 不可能连上 - 确保已执行过
sudo xcodebuild -runFirstLaunch（macOS），否则模拟器服务不注册 - 手动打开 Simulator.app，等它完全加载（状态栏出现时间、信号格），再点一下屏幕解锁（首次启动必须手动解锁，否则不被识别为“ready”）
- 如果仍无输出，运行
xcrun simctl list devices看是否列出设备；若无，说明模拟器未正确注册，需重装 Xcode 或重置模拟器（xcrun simctl shutdown all+xcrun simctl boot）
运行时报 “Could not resolve io.flutter:flutter_embedding_debug”
这是 Gradle 下载 Flutter 内部依赖失败，本质是 Maven 仓库地址被拦截或不可达，和 VS Code 无关，但错误发生在 F5 构建阶段，容易误判为编辑器问题。
- 修改项目根目录下的
android/build.gradle，在allprojects → repositories块中，把maven { url "https://storage.googleapis.com/download.flutter.io" }改成maven { url "http://download.flutter.io" }（注意是http，不是https） - 同步修改
flutter/packages/flutter_tools/gradle/flutter.gradle中对应 URL（路径以你本地flutter目录为准） - 改完后执行
flutter clean，再在 VS Code 里按F5，不要用终端跑flutter run验证，因为 VS Code 调试器走的是独立构建流程 - 如果还失败，检查是否开了代理；某些企业网络会拦截
storage.googleapis.com，但放行download.flutter.io
右下角设备名灰色，点“运行”没反应
灰色 = 设备未就绪。VS Code 的运行按钮是否可用，取决于 Flutter CLI 是否认为该设备处于可调试状态，而不是“是否存在”。
- 确保 VS Code 当前打开的是项目根目录（含
pubspec.yaml和lib/main.dart），打开子文件夹或单个 .dart 文件时插件不会激活设备检测 - iOS 模拟器必须已解锁，且当前前台活跃（不能最小化或后台挂起）；Android 模拟器需已启动并完成系统初始化（看到主屏幕，而非“Starting…”）
- 如果设备名是灰色但
flutter devices能看到它，尝试在 VS Code 中执行Flutter: Refresh Devices（Cmd+Shift+P） - 极少数情况是 Flutter daemon 卡死：终端执行
killall -9 flutter，再重启 VS Code
最容易被忽略的点是：VS Code 从不读取系统 PATH 中的 flutter，哪怕 flutter --version 在终端里能跑，只要 dart.flutterSdkPath 没配，调试器就等于不存在。路径填错、没 Reload Window、模拟器没解锁——这三个动作漏掉任何一个，F5 都会静默失败。
