跨平台开发 / 系统课时
安装 Dart 3.13 开发环境
安装 Dart 3.13 开发环境
这一篇完成可验证的 Dart 3.13 本地基线:按操作系统安装 SDK,让终端能够找到 dart,再用版本与帮助命令验收。完成后,后续课程可以直接以命令行运行、格式化、分析和创建 Dart 项目。
学习目标
- 在 Windows、macOS 或 Ubuntu/Debian 上安装 Dart 3.13 stable SDK
- 理解
PATH为什么决定终端能否找到dart - 能用
dart --version与dart --help判断安装是否真正可用
安装前先确定 SDK 来源
本课程以 Dart 3.13 为语言与工具基线。Dart 3.13 于 2026 年 8 月发布,官方安装页默认推荐使用包管理器获取 stable channel;在 3.13 仍是当前 stable 时,这条路径最省事。
如果你在更晚时间执行本文,而 stable channel 已升级到 3.14 或更高版本,包管理器通常会安装新的 stable。此时应从 Dart SDK Archive 选择 3.13.x,而不是把“最新版”误认为“3.13”。
按操作系统安装 SDK
只执行与你当前系统对应的一组命令。安装过程中需要联网;Windows 的 Chocolatey 安装需要提升权限,Ubuntu/Debian 的系统包操作需要 sudo。
Windows
先安装 Chocolatey,然后以管理员身份打开 PowerShell,执行:
choco install dart-sdk -y预期结果:
安装命令成功结束,dart-sdk 已安装;具体下载进度、缓存路径和完成日志会随 Chocolatey 版本变化。Chocolatey 默认把 Dart SDK 放在 C:\tools\dart-sdk。正常情况下安装器会处理终端可访问路径;如果当前窗口仍找不到 dart,先新开一个 PowerShell 再验证。
macOS
已安装 Homebrew 时,使用 Dart 官方 tap:
brew tap dart-lang/dart
brew trust dart-lang/dart
brew install dart预期结果:
安装命令成功结束,Dart stable SDK 已由 Homebrew 安装并链接;具体下载与链接日志会随 Homebrew 版本变化。能够正常执行 brew 通常意味着 Homebrew 自身的可执行目录已经在 PATH 中,Dart 安装完成后会通过该目录暴露 dart 命令。
Ubuntu 或 Debian
先安装仓库所需工具和签名密钥,再添加 Dart stable 软件源。下面用 dpkg --print-architecture 自动取得当前 Debian 架构,避免把 amd64 写死:
sudo apt-get update
sudo apt-get install -y apt-transport-https gpg wget
wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub \
| sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg
ARCH="$(dpkg --print-architecture)"
echo "deb [signed-by=/usr/share/keyrings/dart.gpg arch=$ARCH] https://storage.googleapis.com/download.dartlang.org/linux/debian stable main" \
| sudo tee /etc/apt/sources.list.d/dart_stable.list
sudo apt-get update
sudo apt-get install -y dart预期结果:
安装命令成功结束,APT 已安装 stable channel 的 dart 包;仓库索引、下载大小和安装日志会随发行版、架构与镜像状态变化。这组命令适用于官方支持的 Debian/Ubuntu 软件包路径。其他 Linux 发行版不要强行套用 APT 命令,应改用官方 SDK Archive 或该发行版明确支持的安装方案。
让终端能够找到 dart
PATH 是终端查找可执行文件时依次搜索的一组目录。安装成功但输入 dart 提示“command not found”或“不是内部或外部命令”,通常不是 Dart 代码有问题,而是当前终端还没有看到 SDK 的 bin 目录。
Windows 使用 Chocolatey 默认路径且重开 PowerShell 后仍无法识别时,可以把 SDK 的 bin 加入当前用户 PATH。以下命令会避免重复追加同一路径:
$dartBin = 'C:\tools\dart-sdk\bin'
$userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
# 只在用户 PATH 中尚不存在时持久化,并同步更新当前 PowerShell。
if (($userPath -split ';') -notcontains $dartBin) {
[Environment]::SetEnvironmentVariable('Path', "$dartBin;$userPath", 'User')
}
$env:Path = "$dartBin;$env:Path"预期结果:
命令通常不输出文本;当前 PowerShell 可以立即搜索 C:\tools\dart-sdk\bin,新开的终端会读取更新后的用户 PATH。macOS 的 Homebrew 与 Ubuntu/Debian 的 APT 一般会把可执行文件链接到包管理器已经管理的目录,因此不要随意复制 dart 二进制文件来“修复” PATH。先重开终端;若仍失败,应检查包管理器安装是否成功以及 shell 是否加载了其标准环境配置。
用版本和帮助命令验收
安装完成后,在一个新终端执行以下两条命令。它们分别验证“找到的是哪个 SDK”和“CLI 能否正常启动”:
dart --version
dart --help预期输出:
Dart SDK version: 3.13.<PATCH> (stable) (<BUILD_TIME>) on "<PLATFORM>"
<HELP_TEXT><PATCH>、<BUILD_TIME>、<PLATFORM> 会随具体补丁版本、构建和操作系统不同;<HELP_TEXT> 是当前 SDK 的帮助内容,应能看到 run、create、compile、format、pub 等命令。课程基线要求版本号的主次版本为 3.13。
处理最常见的安装偏差
如果版本不是 3.13.x,先判断原因。显示 3.14 或更高版本,通常是执行时 stable channel 已升级;需要严格跟随课程版本时,从官方 SDK Archive 安装 3.13.x 并让它在 PATH 中优先。显示较旧版本,则通常是系统里已有另一套 Dart SDK。
如果机器同时安装了 Flutter 和独立 Dart SDK,还可能出现“编辑器使用一套、终端使用另一套”的情况。课程阶段应固定一套 3.13.x 作为基线,避免同一份代码被不同 SDK 分析或格式化。
最终验收标准很简单:新开的终端能直接执行 dart,dart --version 显示 3.13.x stable,dart --help 能正常列出 CLI 命令。满足这三点后,环境才算真正可用于后续 Dart 语言练习。