如何设置VSCode以支持Dart编程语言开发？

本文共计895个文字，预计阅读时间需要4分钟。

安装好Dart SDK并正确配置后，使用VSCode才能识别PATHVSCode能够识别dart命令，因为Dart插件本身不包含SDK，它只是一个控制器，没有SDK就无法运行。

dart run 报 “command not found” 怎么办

这是最常卡住的第一步：VSCode 终端或调试器找不到 dart 命令。根本原因不是插件没装，而是系统压根没装 Dart SDK，或者装了但没加进 PATH。

• 去 dart.dev/get-dart 下载独立 Dart SDK（ZIP 包），别从 Flutter 目录里硬扒 dart-sdk 出来用
• 解压后把 bin 目录路径加入系统 PATH：
  – macOS/Linux：编辑 ~/.zshrc，加一行 export PATH="/path/to/dart-sdk/bin:$PATH"，然后运行 source ~/.zshrc
  – Windows：系统属性 → 环境变量 → 编辑 Path → 新建 → 粘贴 dart-sdk\bin 的绝对路径
• 新开终端，执行 dart --version 能输出版本号才算成功；再重启 VSCode，插件才能读到这个环境变量
• VSCode 设置里搜 dart.sdkPath，留空即可——插件默认从 PATH 自动找；只有你本地装了多个 Dart 版本时，才需要手动填绝对路径

launch.json 断点不命中，怎么写才对

VSCode 默认生成的调试配置是为 Flutter 项目设计的，直接套在纯 Dart CLI 项目上，大概率断点灰色、控制台只显示 “Waiting for connection”。

• 确保项目根目录有 pubspec.yaml（哪怕只有 name: myapp 两行），否则插件不认为这是个 Dart 项目
• 在项目根目录建 .vscode/launch.json，用这个最小可用模板：

{ "version": "0.2.0", "configurations": [ { "name": "Dart: Run", "type": "dart", "request": "launch", "program": "bin/main.dart", "args": [], "cwd": "${workspaceFolder}" } ] }

• program 必须指向含 main() 的具体文件，比如 bin/main.dart 或 example/test.dart，不能写成 bin/ 目录或 lib/xxx.dart
• 别在终端手动敲 dart debug bin/main.dart 启动——VSCode 的 dart 类型调试器不走这条路，硬塞会报错或跳过断点

pub get 失败，提示 “Could not find a file named ‘pubspec.yaml’”

这不是网络问题，也不是权限问题，是 VSCode 根本没“认出”你当前打开的是一个 Dart 项目。

• 必须用 VSCode 的 File → Open Folder 打开**包含 pubspec.yaml 的那个文件夹**，而不是双击打开单个 .dart 文件
• 确认 pubspec.yaml 在根目录，且缩进全用空格（不能用 Tab），name: 和 version: 字段不能缺
• 右键点击 pubspec.yaml → 选 “Dart: Get Packages”，比在终端敲 pub get 更可靠——插件会自动匹配当前工作区的 SDK 和上下文
• 如果右下角状态栏一直显示 “analyzing…” 卡住，按 Ctrl+Shift+P 运行 Dart: Restart Analysis Server

最容易被忽略的一点：Dart SDK 和 Flutter SDK **不能混用路径**。如果你只写 CLI 工具，就装独立 Dart SDK；如果写 Flutter，就只配 dart.flutterSdkPath，并删掉 dart.sdkPath —— 否则 package:flutter/material.dart 一定报红，而且 pub get 会静默失败。