VSCode调试Dart命令行程序的核心是：使用type为"dart"的调试器、program指向bin/下的入口文件、项目含合规pubspec.yaml；需确保dart命令全局可用且被VSCode读取（通过shell启动或手动配置dart.sdkPath），并以文件夹方式打开项目根目录。
VSCode 调试 Dart 命令行程序，核心就一条：必须用 dart 类型调试器 + 正确指向 bin/ 下的入口文件，且项目结构合规。其他所有问题——断点不命中、F5 卡住、“No debug adapter found”——基本都卡在这三处。
确认 dart 命令全局可用，且被 VSCode 读到
VSCode 的 Dart 插件不查系统 PATH，只继承你 shell 启动时的环境变量。终端里 dart --version 有输出，不代表 VSCode 能看到。
- macOS/Linux：必须用终端执行
code .打开项目；双击图标启动的 VSCode 不会加载~/.zshrc里的PATH - Windows：在「系统属性 → 高级 → 环境变量」中把
dart-sdk\bin（不是dart-sdk根目录）加进系统 PATH，改完要彻底退出 VSCode 再重开 - 验证方式：在 VSCode 内置终端里运行
which dart（macOS/Linux）或where dart（Windows），必须有输出；再跑dart --version - 如果仍失败，在 VSCode 设置里搜
dart.sdkPath，手动填入完整路径，例如/usr/local/share/dart-sdk/bin—— 注意是bin目录，不是 SDK 根目录
用 Open Folder 打开含合法 pubspec.yaml 的项目根目录
VSCode 的 Dart 插件只在识别到合规的 pubspec.yaml 时才激活完整语言服务。单文件打开、路径错层、缩进用 Tab，都会让插件“装死”。
-
pubspec.yaml必须在项目根目录，不能藏在子文件夹里 - 最简合法内容至少含
name:和version:，且缩进只能用空格（YAML 敏感） - 示例：
name: my_cli_tool version: 0.1.0 environment: sdk: '>=3.0.0 <4.0.0'
- 右键点击
pubspec.yaml→ 选Dart: Get Packages，别在终端敲dart pub get—— 插件绑定的 SDK 才能生成正确的.dart_tool缓存
launch.json 中 type 和 program 必须严格匹配 CLI 场景
纯 Dart CLI 项目（不 import package:flutter/*）必须用 "type": "dart"，设成 "flutter" 会导致跳过引擎初始化、断点全灰、控制台只打印一行 “Launching…” 就结束。
-
"program"字段必须是具体文件路径，例如"bin/main.dart"或"${workspaceFolder}/bin/main.dart" - 不能写
"lib/main.dart"（那是 Flutter 入口习惯）、不能写目录名、不能写相对路径如./bin/main.dart - 推荐最小可用配置：
{ "version": "0.2.0", "configurations": [ { "name": "Debug CLI", "type": "dart", "request": "launch", "program": "bin/main.dart" } ] } - 如果项目没
pubspec.yaml，VSCode 默认不启用调试支持；此时可手动创建一个最简pubspec.yaml，或改用终端命令dart run bin/main.dart临时调试
容易被忽略的细节：分析器与 DevTools 支持
纯 Dart CLI 项目默认可能不启用完整类型推导和重构提示，且 DevTools 连接需手动触发——这些不会报错，但会明显降低开发体验。
- 在项目根目录新建
analysis_options.yaml，启用严格模式：analyzer: enable-experiment: [records, patterns] language: strict-casts: true strict-inference: true - 在 VSCode 设置中搜
dart.analyzerAdditionalArgs，添加["--enable-asserts"] - 想用 DevTools 分析内存/CPU：先终端执行
dart run devtools，再 F5 启动调试，从调试控制台找Observatory listening on http://127.0.0.1:8181，粘贴到 DevTools 的 Connect 输入框
