根本原因是VSCode未正确识别Dart SDK路径：需手动配置dart.sdkPath为SDK的bin目录完整路径（如/usr/local/share/dart-sdk/bin），并重启VSCode；仅依赖PATH不可靠，因VSCode启动时不继承shell环境变量。
VSCode 里 Dart 插件报 “Dart SDK not found” 或状态栏不显示 Dart 标识，根本原因不是插件没装，而是它压根没找到你本地的 dart 命令——哪怕终端里 dart --version 能跑，VSCode 启动时也可能完全读不到 PATH。
dart.sdkPath 设置必须指向 bin 目录，且不能留空（除非 PATH 真的可靠）
VSCode 的 Dart 插件默认会从系统 PATH 查找 dart，但这个行为只在启动时触发一次，且容易被 shell 配置、终端类型（如 VSCode 内置终端 vs 外部 Terminal）、多 Shell 初始化文件（~/.zshrc vs ~/.zprofile）干扰。最稳的方式是手动填死路径。
-
dart.sdkPath的值必须是 SDK 的bin目录完整路径，例如/usr/local/share/dart-sdk/bin（macOS/Linux）或C:\src\dart-sdk\bin（Windows），结尾不能是dart-sdk根目录，也不能漏掉/bin - 如果同时装了 Flutter SDK，又想用独立 Dart SDK（比如写 CLI 工具），就别碰
dart.flutterSdkPath；反之，纯 Flutter 项目则应只配dart.flutterSdkPath，并清空dart.sdkPath - 填完后必须重启 VSCode（不是重载窗口），否则设置不生效
为什么 which dart 成功，VSCode 却找不到？
常见于 macOS 和 Windows 用户：终端能运行 dart --version，是因为你当前 shell（比如 zsh）读了 ~/.zshrc 并加载了 PATH；但 VSCode 图形界面启动时，可能走的是 launchd 环境（macOS）或登录会话环境（Windows），根本没执行你的 shell 配置文件。
- macOS：检查
echo $PATH在 VSCode 内置终端和外部终端是否一致；不一致就说明 VSCode 没继承 shell 的 PATH - Windows：系统环境变量里加了 PATH，但用户变量里没加，或者改完没重启 VSCode
- 验证方式：在 VSCode 内置终端里直接运行
which dart，如果没输出，说明它真没看到
调试时 program 找不到文件？多半是 SDK 路径错导致分析器没加载
即使 launch.json 里 "program": "bin/main.dart" 写对了，F5 还是报 Cannot open file 或断点灰掉，往往不是路径问题，而是 Dart 分析服务器根本没起来——因为 SDK 路径错误，插件无法解析 pubspec.yaml、生成 .dart_tool/、建立符号索引。
- 确保项目是用 File → Open Folder 打开整个含
pubspec.yaml的根目录，不是单个.dart文件 -
pubspec.yaml必须合法：至少含name:和version:，缩进全为空格，无 Tab - 右键
pubspec.yaml→ Dart: Get Packages，而不是手动敲dart pub get；前者强制走插件绑定的 SDK，后者可能调用 PATH 里另一个版本
最容易被忽略的一点：VSCode 的 Dart 插件对 SDK 路径敏感度远高于终端——它不关心你“能不能用”，只认“它自己能不能精确加载”。路径差一个字符、多一个斜杠、用了软链接没展开，都可能导致语言服务静默失败，而错误提示却藏在 Output → Dart 面板里，不主动点开根本看不到。
