跨平台开发 / 系统课时

安装 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,执行:

powershell
choco install dart-sdk -y

预期结果:

text
安装命令成功结束,dart-sdk 已安装;具体下载进度、缓存路径和完成日志会随 Chocolatey 版本变化。

Chocolatey 默认把 Dart SDK 放在 C:\tools\dart-sdk。正常情况下安装器会处理终端可访问路径;如果当前窗口仍找不到 dart,先新开一个 PowerShell 再验证。

macOS

已安装 Homebrew 时,使用 Dart 官方 tap:

bash
brew tap dart-lang/dart
brew trust dart-lang/dart
brew install dart

预期结果:

text
安装命令成功结束,Dart stable SDK 已由 Homebrew 安装并链接;具体下载与链接日志会随 Homebrew 版本变化。

能够正常执行 brew 通常意味着 Homebrew 自身的可执行目录已经在 PATH 中,Dart 安装完成后会通过该目录暴露 dart 命令。

Ubuntu 或 Debian

先安装仓库所需工具和签名密钥,再添加 Dart stable 软件源。下面用 dpkg --print-architecture 自动取得当前 Debian 架构,避免把 amd64 写死:

bash
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

预期结果:

text
安装命令成功结束,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。以下命令会避免重复追加同一路径:

powershell
$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"

预期结果:

text
命令通常不输出文本;当前 PowerShell 可以立即搜索 C:\tools\dart-sdk\bin,新开的终端会读取更新后的用户 PATH。

macOS 的 Homebrew 与 Ubuntu/Debian 的 APT 一般会把可执行文件链接到包管理器已经管理的目录,因此不要随意复制 dart 二进制文件来“修复” PATH。先重开终端;若仍失败,应检查包管理器安装是否成功以及 shell 是否加载了其标准环境配置。

用版本和帮助命令验收

安装完成后,在一个新终端执行以下两条命令。它们分别验证“找到的是哪个 SDK”和“CLI 能否正常启动”:

bash
dart --version
dart --help

预期输出:

text
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 语言练习。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Dart 3.13 开发环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通