独立运行 Dart（不依赖 Flutter）在 VSCode 中完全可行，关键在于 Dart 插件必须显式配置正确的 SDK 路径（如 /usr/local/share/dart-sdk/bin），且须以文件夹方式打开含合规 pubspec.yaml 的项目，再右键执行“Dart: Get Packages”触发插件绑定的 SDK 解析依赖，调试时 launch.json 的 program 字段需准确指向 bin/ 下入口文件。
独立运行 Dart（不依赖 Flutter）在 VSCode 中完全可行，但关键在于SDK 路径必须由 Dart 插件直接识别，且 pub get 不能靠手动敲命令——它得走插件绑定的 SDK 才能正确解析依赖、生成 .dart_tool 和分析器缓存。
确认 Dart SDK 已安装并被 VSCode 识别
VSCode 的 Dart 插件不会自动找系统 PATH 里的 dart，它默认只信任你明确告诉它的 SDK 路径。常见错误是：终端里 dart --version 成功，但 VSCode 状态栏右下角没有显示 Dart 标识，或者打开 .dart 文件没语法高亮、无补全。
- 先在终端运行
which dart（macOS/Linux）或where dart（Windows），拿到 SDK 的真实bin目录路径（例如/usr/local/share/dart-sdk/bin） - 打开 VSCode 设置（
Cmd + ,或Ctrl + ,），搜索dart.sdkPath - 在设置项中填入完整路径，注意是
bin目录，不是dart-sdk根目录 - 重启 VSCode，状态栏右下角应出现
Dart字样；若仍不显示，检查插件是否为官方Dart Code（ID:Dart-Code.dart-code），非第三方“Dart”别名插件
必须用文件夹方式打开项目，且 pubspec.yaml 要合规
VSCode 的 Dart 插件只有在打开包含 pubspec.yaml 的文件夹时，才会激活完整的语言服务（包括依赖解析、跳转、重构）。单文件打开或错误格式的 pubspec.yaml 会导致 Dart: Get Packages 命令灰掉或失败。
-
pubspec.yaml必须位于项目根目录，不能套在子文件夹里 - 最简合法结构至少含
name:和version:，且缩进只能用空格（不能用 Tab） - 示例：
name: my_cli_tool version: 0.1.0 environment: sdk: '>=3.0.0 <4.0.0'
- 右键点击
pubspec.yaml→ 选择Dart: Get Packages，而不是在终端执行pub get；前者会强制使用插件配置的 SDK，避免混用不同版本导致的Could not find a file named "pubspec.yaml"
调试配置 launch.json 时 program 路径要写对
VSCode 自动生成的 launch.json 往往默认指向 lib/main.dart，但 Dart CLI 项目习惯把入口放在 bin/ 下。路径错一个字符，F5 就报 Cannot open file: 'lib/main.dart'。
- 确保
program字段值是相对项目根目录的路径，比如你的主文件是bin/server.dart，就写"program": "bin/server.dart" - 不要加前缀
./或../，VSCode 的 Dart 调试器不认这些 - 如果项目有多个可执行入口，建议每个都建独立的 launch 配置，避免反复改
program - 首次按 F5 时，若弹出“选择环境”菜单，选
Dart & Flutter，它生成的模板才带正确 type 和 request 字段
离线或国内网络环境下依赖下载失败怎么办
国内直连 pub.dev 经常超时或返回 403，Dart: Get Packages 会卡住或报 Connection refused，但插件本身不提供镜像配置入口。
- 临时方案：在终端进入项目根目录，手动运行
dart pub add args（举例），前提是已配置好dart命令的环境变量且 SDK 可用 - 长期方案：编辑用户级
~/.dart/pubspec.yaml（macOS/Linux）或%APPDATA%\Pub\Cache\config.json（Windows），添加镜像源（如清华源）：{"publish-url": "https://pub.flutter-io.cn","environment": {"sdk": ">=2.12.0"}} - 注意：VSCode 插件不会读这个配置，所以
Dart: Get Packages仍可能失败，但手动dart pub get就能走镜像，之后插件就能正常读取已下载的依赖
最容易被忽略的是：Dart 插件的 SDK 路径和系统 PATH 完全是两套逻辑，哪怕你只装了 Flutter SDK，也得在 VSCode 设置里显式填上它的 flutter/bin/internal/dart-sdk/bin 路径，否则插件根本不知道该用哪个 Dart 运行时——它不会去猜，也不会 fallback。
