目录

获取 Dart SDK

本页面主要引介绍如何下载 Dart SDK,Dart SDK 包含了各种库和命令行工具帮助你构建 Dart 命令行、服务端、以及 Web (非 Flutter) 应用。了解更多,请查看 Dart SDK 概览

安装 Dart SDK

如下所述,你可以使用包管理轻松地安装和更新 Dart SDK。你也可以以 编译 SDK 源码 的形式安装,也可以在我们的 各个发布渠道里 下载 SDK 的 zip 压缩文件

Note: The Flutter SDK includes the full Dart SDK, and has Dart’s dart command-line interface in its bin folder.

You can install the Dart SDK using Chocolatey.

安装 Dart SDK:

C:\> choco install dart-sdk

升级 Dart SDK:

C:\> choco upgrade dart-sdk

SDK 默认会安装在 C:\tools\dart-sdk。你可以更改 ChocolateyToolsLocation 环境变量来选择安装目录。

如果安装后你无法使用 Dart SDK 的可执行文件,请将 SDK 的路径添加到 PATH:

  1. 打开 Windows 搜索,输入 env

  2. 点击 编辑系统环境变量

  3. 点击 环境变量(N)…

  4. 在用户变量部分,选择 Path 并点击 编辑(E)…

  5. 点击 新建(N),输入 dart-sdk 的路径。

  6. 在每个打开的窗口点击 应用(A)确定,关闭弹窗并应用路径修改。

如果您使用 64 位的 Debian/Ubuntu 系统,请选择下面任意一种方式安装,在新版本发布之后,它们都可以自动更新。

使用 apt-get 方式安装

请使用如下的方式(只需设置一次):

$ sudo apt-get update
$ sudo apt-get install apt-transport-https
$ wget -qO- https://dl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg
$ echo 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64] https://storage.googleapis.com/download.dartlang.org/linux/debian stable main' | sudo tee /etc/apt/sources.list.d/dart_stable.list

中国的开发者,请将上面最后一行命令行的 storage.googleapis.com 替换为 storage.flutter-io.cn,完整命令如下:

$ echo 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64] https://storage.flutter-io.cn/download.dartlang.org/linux/debian stable main' | sudo tee /etc/apt/sources.list.d/dart_stable.

然后安装 Dart SDK:

$ sudo apt-get update
$ sudo apt-get install dart

使用 Debian 安装包

通过 .deb 软件包 下载 Dart SDK。

在 PATH 环境变量里加入所有 Dart 二进制文件的访问

安装 SDK 之后需要把 SDK 的 bin 目录加入你环境变量的 PATH 中去。比如,通过下面的命令可以在现有命令行窗口中加入 PATH 环境变量:

$ export PATH="$PATH:/usr/lib/dart/bin"

为未来的命令行窗口执行永久的 PATH 环境变量设定,可以使用下面的命令:

$ echo 'export PATH="$PATH:/usr/lib/dart/bin"' >> ~/.profile

安装 Homebrew 后运行以下命令:

$ brew tap dart-lang/dart
$ brew install dart

想要更新到 Dart SDK 可用的更新版本,执行以下命令:

$ brew upgrade dart

想要切换本地 Dart SDK 的版本,在你没有安装之前,需要先行安装对应版本。例如,以下的命令将安装 Dart 2.12:

$ brew install dart@2.12

接着切换版本时,取消当前版本的链接,并链接目标版本。

$ brew unlink dart@<old> && brew unlink dart@<new> && brew link dart@<new>

运行以下命令查看已经安装的 Dart 版本:

$ brew info dart

系统要求

Dart SDK 支持 Windows、Linux 和 macOS。

Windows

  • 支持的版本:Windows 10 和 11。

  • 支持的架构: x64、ia32、ARM64
    ARM64 的支持处于实验性阶段,仅在 Dev 渠道可用。

Linux

  • 支持的版本:已支持标准版的 Debian stable 以及 Ubuntu LTS

  • 支持的架构: x64、IA32、ARM64、ARM、RISC-V (RV64GC)。
    RISC-V 的支持目前还在实验阶段,仅在 Dev 渠道可用。

macOS

  • Supported versions: Latest three major versions. Dart supports the following macOS versions as of November 2022:
    • macOS 11 (Big Sur)
    • macOS 12 (Monterey)
    • macOS 13 (Ventura)

    支持的版本:最新的三个主要版本。截止 2022 年 11 月,支持 macOS 的以下版本 (macOS 10.15 的支持已被移除):

    • macOS 11 (Big Sur)
    • macOS 12 (Monterey)
    • macOS 13 (Ventura)
  • 支持的架构: x64、ARM64。

关于发行渠道和版本字符串

Dart SDK 有三个发布渠道:

  • 稳定版 (Stable) 渠道:稳定发行版,每 三个月 更新一次;当前版本 [calculating].

    稳定版可适用于生产环境。

  • 测试版 (Beta) 渠道:也称 发行预览版,通常 每月 更新一次;当前版本 [calculating].

    测试版渠道的构建是稳定版渠道的“预览版构建”。我们推荐您使用这个渠道的 SDK、进行测试,但是不建议您的应用发布,您可以用这个渠道的构建预览新功能或测试与未来版本的兼容性。

  • 开发版 (Dev) 渠道:也称 预发行版,通常每 双周 更新一次;当前版本 [calculating].

    开发版渠道的构建包含最新的更新,也可能本身就是不完善的,这个版本我们不受支持,并且可能会包含未经审核的重大更改 (breaking changes)。

Dart SDK 稳定版 构建渠道的版本号设定为 x.y.z,比如 1.24.32.1.0。它们由点分隔的整数组成,没有连字符或字母,其中 x 是主版本,y 是次要版本,而 z 是补丁版本。

Dart SDK 的非稳定版 (测试版 (Beta)开发版 (Dev)) 构建渠道的版本号设定为:x.y.z-a.b.<beta|dev>,比如:2.8.0-20.11.beta。连字符前的部分 (x.y.z) 遵循稳定版本方案,连字符后的 ab 分别是预发行版和预发行补丁版本,而 betadev 是构建渠道通道标示。

你可以通过本页面 上方安装部分 的介绍来获取稳定版渠道的 Dart,或者通过 任一个包管理器 (如 brew、choco、apt get)[] 或者通过 Dart 的 Docker 镜像 来获取稳定版 (Stable)、测试版 (Beta)、开发版 (Dev) 渠道的 Dart SDK,再或者,你也可以直接 下载各个版本的 SDK 压缩包

你可以查阅 Dart 2 相关页面 获取更多信息。