为Dart语言配置VS Code以进行Web和服务器端开发

12次阅读

需安装官方Dart SDK并配置PATH,vs code中仅装Dart-Code扩展;Web项目用dart create建web-simple模板后执行“Dart: Start Debugging Web”,服务器端项目用console-simple模板后右键“Debug Dart Script”即可调试。

为Dart语言配置VS Code以进行Web和服务器端开发

要在 VS Code 中为 Dart 语言配置 Web 和服务器端开发环境,核心是装对扩展、配好 SDK,并区分不同项目类型(Web / CLI / Server)的运行方式。不需要重装系统或复杂脚本,几步就能跑起来。

Dart SDK 是基础,必须先装好

Dart SDK 不随 VS Code 自动安装,必须单独获取。推荐从 https://dart.dev/get-dart 下载官方 SDK(选对应系统的 ZIP 或安装包),解压后把 bin 目录路径加入系统 PATH。验证是否成功:终端运行 dart --versiondart pub --version,有输出即 OK。

  • windows 用户注意:添加 PATH 后需重启 VS Code(不是仅关窗口,要彻底退出进程)
  • macOS / linux 用户若用 zsh,记得在 ~/.zshrc 中写入 export PATH="/path/to/dart-sdk/bin:$PATH" 并执行 source ~/.zshrc
  • 别用 brew install dart(旧版已弃用),也不要用 flutter 自带的 dart(版本可能不匹配 Web 编译需求)

VS Code 扩展只装一个:Dart Code

在扩展市场搜 “Dart”,认准作者是 Dart-Code(图标是蓝色 D)。这是唯一需要的官方扩展,它同时支持 Dart CLI、Web(通过 dart2js 或 DDC)、以及服务器端(如使用 shelf、aqueduct 等框架)。

  • 卸载其他名字相似的扩展,比如 “Dart Snippets”、“Dart Tools” —— 它们功能重复或已过时
  • 启用后,VS Code 会自动识别 .dart 文件、提供智能补全、调试支持和热重载(Web 项目中按 Ctrl+F5 启动调试)
  • 设置里建议开启 "dart.previewLsp": true(新版默认已开),提升大型项目的响应速度

Web 开发:用 webdev 或直接集成到 VS Code

Web 项目依赖 webdev 工具(基于 build_runner),但不用手动全局安装。Dart Code 扩展会自动调用项目本地的 webdev(通过 pubspec.yaml 中声明的 dev_dependency)。

  • 新建 Web 项目:终端运行 dart create my_web_app(选 web-simple 模板)
  • 打开项目文件夹后,按 Ctrl+Shift+P → 输入 “Dart: Start Debugging Web” 即可启动 chrome 调试(自动拉起浏览器并监听变更)
  • 若提示找不到 webdev,运行 dart pub get 更新依赖;若仍失败,尝试 dart pub global activate webdev(仅当项目未声明依赖时临时用)

服务器端开发:CLI 项目 + 内置调试即可

服务器端(如 HTTP API、命令行工具)本质是普通 Dart CLI 项目,无需额外服务插件。Dart Code 原生支持运行和调试 bin/*.dart 文件。

  • 新建 CLI 项目:dart create my_server --template=console-simple
  • 编辑 bin/main.dart,写个简单 HTTP server(例如用 shelf
  • 右键点击代码编辑区 → “Debug Dart Script”,或按 F5 → 选择 “Dart CLI” 环境,即可断点调试
  • 如需热重载后端逻辑,可用 watch 工具(如 pub global activate dwds 配合自定义脚本,但非必需)

基本上就这些。没有隐藏配置项,也不用改 launch.json(除非你有特殊端口或参数需求)。只要 SDK 正确、扩展启用、项目结构合规,VS Code 就能自动识别并提供完整开发体验。

text=ZqhQzanResources