Skip to content

第2章:开发环境搭建

2.1 基础环境准备

Windows系统

  1. 下载 Dart SDK

  2. 安装 Dart SDK

    • 运行下载的安装程序
    • 按照安装向导的提示完成安装
    • 选择 "Add Dart to PATH" 选项,这样可以在命令行中直接使用 Dart 命令
  3. 配置环境变量(如果安装时未选择添加到 PATH)

    • 右键点击 "此电脑" → "属性" → "高级系统设置" → "环境变量"
    • 在 "系统变量" 中找到 "Path" 变量,点击 "编辑"
    • 点击 "新建",添加 Dart SDK 的安装路径(默认路径为 C:\Program Files\Dart\dart-sdk\bin
    • 点击 "确定" 保存更改

Mac系统

  1. 使用 brew 安装(推荐)

    • 打开终端
    • 运行命令:brew tap dart-lang/dart
    • 运行命令:brew install dart
  2. 手动下载安装

    • 访问 Dart 官方网站
    • 点击 "Download Dart SDK" 按钮
    • 选择 Mac 版本下载
    • 解压下载的文件到合适的位置(如 ~/dart-sdk
    • 将 Dart SDK 的 bin 目录添加到 PATH 环境变量中

Linux系统

  1. 使用 apt 安装(Ubuntu/Debian)

    • 打开终端
    • 运行命令:sudo apt-get update
    • 运行命令:sudo apt-get install dart
  2. 使用 yum 安装(CentOS/RHEL)

    • 打开终端
    • 运行命令:sudo yum install dart
  3. 手动下载安装

    • 访问 Dart 官方网站
    • 点击 "Download Dart SDK" 按钮
    • 选择 Linux 版本下载
    • 解压下载的文件到合适的位置(如 ~/dart-sdk
    • 将 Dart SDK 的 bin 目录添加到 PATH 环境变量中

2.2 开发工具准备

VS Code + 必备插件

  1. 安装 VS Code

  2. 安装 Dart 插件

    • 打开 VS Code
    • 点击左侧的 "扩展" 图标
    • 在搜索框中输入 "Dart"
    • 点击 "安装" 按钮
  3. 安装 Flutter 插件(提前适配后续 Flutter 学习)

    • 在 VS Code 扩展中搜索 "Flutter"
    • 点击 "安装" 按钮

Android Studio

  1. 安装 Android Studio

  2. 安装 Dart 插件

    • 打开 Android Studio
    • 点击 "File" → "Settings" → "Plugins"
    • 在搜索框中输入 "Dart"
    • 点击 "Install" 按钮
  3. 安装 Flutter 插件

    • 在 Android Studio 插件中搜索 "Flutter"
    • 点击 "Install" 按钮

2.3 环境验证

  1. 查看 Dart 版本

    • 打开命令行或终端
    • 运行命令:dart --version
    • 如果安装成功,会显示 Dart SDK 的版本信息
  2. 运行简单 Dart 文件

    • 创建一个名为 hello.dart 的文件
    • 写入以下代码:
      dart
      void main() {
        print('Hello, Dart!');
      }
    • 运行命令:dart hello.dart
    • 如果输出 "Hello, Dart!",则说明环境配置成功

2.4 Dart 开发工具基础操作

创建 Dart 文件

  1. 在 VS Code 中

    • 打开 VS Code
    • 点击 "File" → "New File"
    • 输入文件名,如 main.dart
    • 保存文件
  2. 在 Android Studio 中

    • 打开 Android Studio
    • 点击 "File" → "New" → "File"
    • 输入文件名,如 main.dart
    • 保存文件

运行程序

  1. 在 VS Code 中

    • 打开 Dart 文件
    • 点击右上角的 "Run" 按钮,或使用快捷键 F5
    • 查看终端中的输出
  2. 在 Android Studio 中

    • 打开 Dart 文件
    • 点击右上角的 "Run" 按钮,或使用快捷键 Shift + F10
    • 查看控制台中的输出
  3. 使用命令行

    • 打开命令行或终端
    • 进入 Dart 文件所在的目录
    • 运行命令:dart 文件名.dart

调试代码

  1. 在 VS Code 中

    • 打开 Dart 文件
    • 在代码行号左侧点击,添加断点
    • 点击 "Debug" 按钮,或使用快捷键 F5
    • 使用调试工具栏控制调试过程
  2. 在 Android Studio 中

    • 打开 Dart 文件
    • 在代码行号左侧点击,添加断点
    • 点击 "Debug" 按钮,或使用快捷键 Shift + F9
    • 使用调试工具栏控制调试过程

2.5 常见环境问题排查

SDK 安装失败

  • 问题:下载 SDK 时网络错误 解决方案:尝试使用镜像源,或使用 brew(Mac)、apt(Linux)等包管理器安装

  • 问题:安装过程中权限不足 解决方案:使用管理员权限运行安装程序,或在命令前添加 sudo(Mac/Linux)

环境变量配置错误

  • 问题:命令行中无法识别 dart 命令 解决方案:检查环境变量 PATH 是否正确配置,重新启动命令行或终端

程序无法运行

  • 问题:运行 Dart 程序时出现 "command not found" 错误 解决方案:检查环境变量配置,确保 Dart SDK 的 bin 目录在 PATH 中

  • 问题:运行 Dart 程序时出现语法错误 解决方案:检查代码语法,确保代码符合 Dart 语法规范

  • 问题:运行 Dart 程序时出现类型错误 解决方案:检查变量类型,确保类型匹配

开发工具问题

  • 问题:VS Code 中无法识别 Dart 文件 解决方案:确保已安装 Dart 插件,重启 VS Code

  • 问题:Android Studio 中无法运行 Dart 程序 解决方案:确保已安装 Dart 插件,检查项目配置

其他问题

  • 问题:Dart SDK 版本过旧 解决方案:访问官方网站下载最新版本的 SDK,或使用包管理器更新

  • 问题:无法访问 Dart 官方网站 解决方案:尝试使用代理,或使用国内镜像源

© 2026 编程马·菜鸟教程 版权所有