vscode本身不执行dart或flutter代码，仅调用本地dart/flusher命令；f5无反应或“no debug adapter found”主因是插件未启动语言服务，根源在于dart命令未全局可用、vscode未继承shell环境path、插件未全局启用、launch.json中type设错（纯dart用"dart"，flutter项目必须用"flutter"）、dart.fluttersdkpath未正确指向flutter根目录，且项目须以文件夹方式打开并含合规pubspec.yaml。
VSCode 本身不执行 Dart 或 Flutter 代码，它只调用你本地装好的 dart 或 flutter 命令；只要终端里 dart --version 和 flutter --version 都能正常输出，VSCode 就具备执行基础——但插件必须认得路径、项目结构要合规、调试配置不能错类型。
为什么 F5 按下没反应，或提示 “No debug adapter found”
这不是插件没装，而是 Dart 插件根本没启动语言服务。核心原因是它找不到 dart 可执行文件。
-
dart命令必须在终端全局可用：运行dart --version有输出，且路径已加进系统PATH - VSCode 不继承 shell 环境（尤其 macOS/Linux），如果从 Dock 启动，
~/.zshrc中的PATH可能未加载；建议从终端执行code启动 VSCode - 插件只认“用户级启用”的 Dart 扩展：打开命令面板（
Ctrl+Shift+P），搜Extensions: Show Installed Extensions，右键Dart→Install for all users（Windows）或Install globally（macOS/Linux） - 重启 VSCode 后，打开任意
.dart文件，右下角状态栏应显示类似Dart SDK 3.4.3；不显示就说明插件没活过来
launch.json 中 type 应该设成 "dart" 还是 "flutter"
取决于你要运行的是什么——设错会导致断点不命中、热重载失效、甚至直接报错。
- 纯 Dart CLI 脚本（无
pubspec.yaml，或不含flutter:依赖）：必须设"type": "dart"，且"program"指向你的入口文件（如bin/main.dart） - Flutter 项目（含合法
pubspec.yaml，且依赖flutter:）：必须设"type": "flutter"，"request": "launch"；设成"dart"会跳过 Flutter 引擎初始化，控制台卡在Launching lib/main.dart on Chrome - Flutter Web 调试卡在 “Launching…”：检查
launch.json中type是不是误配成"chrome"或"pwa-chrome"—— 正确值只能是"flutter"
dart.flutterSdkPath 填错了会怎样
这个配置项指向错误，是“终端里 flutter doctor 全绿，但 VSCode 里啥都不行”的最常见原因。
- 必须指向 Flutter SDK 解压后的**根目录**，例如
/Users/you/flutter或C:\src\flutter，绝不能是/flutter/bin - 指向
bin子目录会导致插件找不到packages/flutter_tools，表现为：设备列表为空、热重载按钮灰色、右下角不显示设备选择器 - VSCode 不自动探测 SDK 位置，也不继承系统
PATH；必须手动填绝对路径，在设置中搜索dart.flutterSdkPath→ 编辑settings.json添加一行 - 填完后重启 VSCode，再打开项目根目录（含
pubspec.yaml），等右下角出现Flutter: v3.19.x才算生效
右键 “Run Dart Program” 报 “Target of URI doesn't exist”
这是分析器没加载上下文的典型表现，不是代码写错，而是项目未被识别为有效 Dart 工程。
- VSCode 必须以**文件夹方式打开项目根目录**（不是单个
main.dart文件），且该目录下必须有合法pubspec.yaml -
pubspec.yaml至少需含name:和version:字段，缩进只能用空格（YAML 对 Tab 敏感） - 右键
pubspec.yaml→ 选Dart: Get Packages（别在终端敲dart pub get），插件绑定的 SDK 才能生成正确的.dart_tool缓存 - 如果仍报错，终端手动执行
dart pub get，再等右下角状态栏显示Dart: Ready
整个流程中最容易被忽略的，是 VSCode 启动方式与 shell 环境的脱节——哪怕 PATH 配得再对，从图标点击启动的 VSCode 也可能拿不到 dart 或 flutter 命令。真出问题时，先关掉所有窗口，从终端输入 code 再打开项目，比反复重装插件管用得多。
