VS Code装Dart插件不等于装了Dart SDK，必须手动下载并配置独立Dart SDK；需将dart-sdk/bin加入系统PATH，验证dart --version可用，并在VS Code设置中正确填写dart.sdkPath路径。
VS Code 里装 Dart 插件不等于装了 Dart SDK
很多人点开 Extensions 搜 Dart，装完插件就以为环境齐了——结果运行 dart --version 报错：command not found。插件只是编辑器支持（语法高亮、调试、补全），dart 命令本身来自独立安装的 Dart SDK。
必须手动下载并配置 Dart SDK
去官网 https://www.php.cn/link/7ba39e3f3c2eb55e2353c8ca7a50ce82 下载对应系统的 SDK（推荐稳定版，非 beta）。解压后得到一个 dart-sdk 文件夹，关键是要把其中的 bin 目录加进系统 PATH：
- macOS/Linux：在
~/.zshrc或~/.bash_profile末尾加一行export PATH="$PATH:/path/to/dart-sdk/bin"，然后source ~/.zshrc - Windows：用「系统属性 → 高级 → 环境变量」，在用户或系统
PATH中新增C:\path\to\dart-sdk\bin
验证是否生效：终端新开一个窗口，执行 dart --version 和 flutter --version（如果同时用 Flutter，它自带 Dart SDK，但版本可能滞后；单独装 Dart SDK 更可控）。
VS Code 插件需要知道 SDK 路径
即使 dart 命令能用了，VS Code 的 Dart 插件有时仍报“SDK not found”。这是因为插件默认只查几个固定路径（比如 ~/flutter/bin/cache/dart-sdk），未必能自动定位你手动安装的位置。
解决方法：在 VS Code 设置里搜 dart.sdkPath，填入你解压后的完整路径，例如：
/Users/you/soft/dart-sdk/bin
注意：填的是 bin 目录，不是 dart-sdk 根目录；Windows 下路径用正斜杠或双反斜杠均可，避免单反斜杠被转义。
常见失败场景和绕过方式
遇到 Unable to locate SDK 或断点不触发，先检查这几点：
- VS Code 是不是用命令行启动？图形界面直接双击打开时，可能读不到 shell 配置的
PATH，建议终端里用code .启动 - 插件版本太老？禁用再重装
Dart Code（作者是Dart-Code），别选名字相近的其他 Dart 插件 - 项目根目录下有没有
pubspec.yaml？没有的话插件不会激活 Dart 支持，新建一个空文件也能触发识别 - macOS 上刚装完 SDK 却提示权限问题？可能是 Gatekeeper 阻止了未签名二进制，右键
dart可执行文件 →「显示简介」→ 点「仍要打开」
真正卡住的地方往往不是安装步骤本身，而是路径没生效、插件没刷新、或者 VS Code 没继承 shell 环境——这些细节比下载链接更难排查。
