Dart开发环境搭建需依次完成五步：一、安装Dart SDK并配置PATH；二、安装VSCode及官方Dart插件；三、用dart create初始化项目并执行pub get；四、配置launch.json支持调试；五、运行和调试bin/main.dart验证全流程正常。
如果您刚刚开始使用 VSCode 进行 Dart 开发，但尚未安装必要组件或配置基础环境，则可能无法创建、运行或调试 Dart 项目。以下是完成初始开发环境搭建的完整流程：
本文运行环境：MacBook Air，macOS Sequoia
一、安装 Dart SDK
Dart SDK 是运行和编译 Dart 代码的核心工具集，包含 dart 命令行工具、分析器及标准库。未安装 SDK 将导致 VSCode 无法识别 .dart 文件语法或执行 dart run 等命令。
1、访问 https://dart.dev/get-dart 官方下载页面。
2、选择与 macOS Sequoia 兼容的最新稳定版 macOS ARM64 ZIP 包。
3、解压下载文件到 /usr/local/share/dart-sdk 目录。
4、在终端中执行 echo 'export PATH="/usr/local/share/dart-sdk/bin:$PATH"' >> ~/.zshrc 并运行 source ~/.zshrc 刷新环境变量。
5、输入 dart --version 验证输出版本号且无错误提示。
二、安装 VSCode 及 Dart 插件
VSCode 本身不内置 Dart 支持，需通过官方扩展提供语法高亮、代码补全、热重载和调试器集成。缺少该插件将导致编辑器仅显示纯文本，无法触发任何语言服务功能。
1、前往 https://code.visualstudio.com/Download 下载 macOS 版 VSCode 安装包。
2、双击安装包完成拖拽式安装，并启动 VSCode 应用程序。
3、点击左侧活动栏的扩展图标（四个方块组成的图标），在搜索框中输入 Dart Code。
4、在搜索结果中找到由 Dart Code 团队发布的官方扩展（ID: Dart-Code.dart-code），点击“安装”按钮。
5、安装完成后重启 VSCode，确保状态栏右下角出现 Dart 语言标识。
三、创建并初始化 Dart 项目
使用 dart create 命令可生成符合 Pub 标准结构的项目模板，包含 pubspec.yaml、bin/ 和 lib/ 目录等必需元素。手动创建目录结构易遗漏关键文件，导致 pub get 失败或运行异常。
1、打开终端，切换至目标工作目录，例如 cd ~/Projects。
2、执行 dart create my_first_dart_app，其中 my_first_dart_app 为项目名称。
3、等待命令完成，确认当前目录下已生成名为 my_first_dart_app 的子文件夹。
4、在 VSCode 中选择“文件 > 打开文件夹”，定位并打开该文件夹。
5、观察 VSCode 底部状态栏是否显示 Pubspec file detected. Run 'pub get' to fetch dependencies.，点击该提示或按 Cmd+Shift+P 输入 “Dart: Pub Get” 执行依赖获取。
四、配置 launch.json 启动调试设置
VSCode 默认不预置 Dart 调试配置，需手动添加 .vscode/launch.json 文件以启用断点调试、变量监视和控制台交互。缺少此配置将导致 F5 启动失败或直接跳过调试模式。
1、在 VSCode 中打开命令面板（Cmd+Shift+P），输入并选择 Debug: Open launch.json。
2、若提示“没有 launch.json，是否创建？”，点击“是”，然后选择 Dart & Flutter 环境。
3、在生成的 launch.json 文件中，确认 configurations 数组内存在 type 字段值为 dart 的对象。
4、修改 program 字段指向主入口文件路径，例如 "program": "bin/main.dart"。
5、保存文件后，在 bin/main.dart 中设置断点，按 F5 即可启动调试会话。
五、验证环境可用性
通过运行一个最小可执行 Dart 脚本，可确认 SDK、插件、项目结构与调试配置四者协同正常。任一环节异常均会导致控制台报错或无输出。
1、确保项目根目录下存在 bin/main.dart 文件，内容为：
void main() { print('Hello from Dart!'); }
2、在 VSCode 终端中执行 dart run，观察输出是否为 Hello from Dart!。
3、在 main 函数第一行左侧灰色区域单击设置断点，按 F5 启动调试，确认执行暂停且调试面板显示变量视图。
4、在调试控制台中输入 print(2 + 3)，确认返回结果为 5。
5、打开命令面板（Cmd+Shift+P），输入 Dart: Show Analyzer Logs，检查日志中无严重（Error）级别报错信息。
