跳到主要内容

获取 Dart SDK

此页面介绍如何下载 Dart SDK。Dart SDK 包含开发 Dart 命令行、服务器和 Web 应用程序所需的库和命令行工具。

Dart 团队仅支持 SDK 的最新稳定版本。有关 SDK 发布生命周期和支持版本的完整详细信息,请查看SDK 支持策略

要了解有关 Dart SDK 的更多信息,请查阅Dart SDK 概述

系统要求

#

Dart 支持以下硬件架构和平台版本来开发和运行 Dart 代码。

平台x64IA32 (x86)Arm32Arm64RISC-V (RV64GC)操作系统版本
Windows已验证危险危险已验证do_not_disturb_on10, 11
Linux已验证危险已验证已验证已验证Debian stable,
Ubuntu LTS 在标准支持下
macOS已验证危险do_not_disturb_on已验证do_not_disturb_onmacOS 的最新三个版本
Sonoma (14), Ventura (13), Monterey (12)

verified 所有通道均支持。
error 支持已弃用,并可能在未来的 Dart 版本中删除。
report 支持已弃用,并可能在下一个稳定版本中移除。
dangerous 所有通道均不支持。
do_not_disturb_on 操作系统不支持。

选择安装选项

#

要从 stable channel 安装和更新 Dart SDK,请选择以下选项之一

  1. 使用包管理器(推荐)。

  2. 使用 Dart Docker 镜像

  3. 安装 Flutter.
    如果您已经安装或计划安装 Flutter SDK,它包含了完整的 Dart SDK。Flutter SDK 在 Flutter 的 bin 文件夹中包含了 dart CLI 工具。

  4. SDK Archive 下载 ZIP 压缩包。

  5. 从源代码构建 SDK.

安装 Dart SDK

#

要安装 Dart SDK,请为您的开发平台使用适当的包管理器。

要升级 Dart SDK,请运行相同的命令以从您的包管理器安装 Dart SDK。

使用 Chocolatey 安装

#

要安装 Dart SDK,请使用 Chocolatey。Chocolatey 需要提升的权限

  1. 安装 Chocolatey。

  2. 以提升的权限启动 PowerShell

    PS C:\> choco install dart-sdk

更改默认安装路径

#

默认情况下,Chocolatey 将 SDK 安装在 C:\tools\dart-sdk。要更改该位置,请将 ChocolateyToolsLocation 环境变量设置为您所需的安装目录。

验证您的 PATH 包含 Dart

#

验证您可以运行 Dart。

PS C:\> dart --version
Dart SDK version: 3.2.4 (stable) (Thu Dec 21 19:13:53 2023 +0000) on "win_x64"

如果您的开发机器未返回 Dart 版本,请将 SDK 位置添加到您的 PATH

  1. 在 Windows 搜索框中,键入 env
  2. 点击 编辑系统环境变量
  3. 点击 环境变量...
  4. 在用户变量部分,选择 Path 并点击 编辑...
  5. 点击 新建,并输入 dart-sdk 目录的路径。
  6. 在您刚刚打开的每个窗口中,点击 应用确定 以关闭它并应用路径更改。

使用 Chocolatey 升级

#

要升级 Dart SDK,请使用以下命令。

PS C:\> choco upgrade dart-sdk

使用 Chocolatey 卸载

#

要卸载 Dart SDK,请执行以下步骤。

  1. 以提升的权限启动 PowerShell

  2. 使用以下命令。

    PS C:\> choco uninstall dart-sdk
  3. 从您的主目录中删除 Dart 配置文件。

    PS C:\> Remove-Item -Recurse -Force ^
         -Path $env:LOCALAPPDATA\.dartServer,$env:APPDATA\.dart,$env:APPDATA\.dart-tool

使用 Linux 包管理器安装

#

您有两种选择在 Ubuntu 或 Debian 上安装 Dart SDK

  • 使用 apt-get 命令。
  • 下载 .deb 包并运行 dpkg 命令。

使用 apt-get 包管理器安装

#

要使用 apt-get 安装 Dart,请执行以下步骤。您只需在首次安装时执行步骤 1 到 3。

  1. 更新软件包索引文件并安装安全 HTTP 软件包。

    $ sudo apt-get update && sudo apt-get install apt-transport-https
  2. 下载并添加 Google Linux GPG 公钥。

    $ wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub \
      | sudo gpg  --dearmor -o /usr/share/keyrings/dart.gpg
  3. 将 Dart 软件包存储库添加到您的 Linux 系统。

    $ 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
  4. 使用以下 sudo apt-get 命令。

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

以 Debian 包安装

#

要将 Dart SDK 作为 Debian 包 (*.deb) 安装,请执行以下步骤。

  1. 下载 Dart SDK Debian 包

  2. 使用 sudo dpkg 命令安装 *.deb 包。

    $ sudo dpkg -i dart_3.4.0-1_amd64.deb

    dart_3.4.0-1_amd64.deb 替换为当前文件名。

升级 Dart SDK

#

使用您用于安装 SDK 的相同命令。

使用 apt-get 升级

#

如果您使用 apt-get 安装了 Dart SDK,请使用以下 sudo apt-get 命令。

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

使用 dpkg 升级

#

如果您使用 dpkg 安装了 Dart SDK,请使用 sudo dpkg 命令。

$ sudo dpkg -i dart_3.2.6-1_amd64.deb

dart_3.4.0-1_amd64.deb 替换为新升级的文件名。

卸载 Dart SDK

#

使用 apt-get 卸载

#

如果您使用 apt-get 安装了 Dart SDK,请使用 sudo apt-get remove 命令。

  1. 使用 sudo apt-get remove 命令。

    $ sudo apt-get remove -y dart
  2. 从您的主目录中删除 Dart 配置文件。

    $ rm -rf  ~/.dart*

使用 dpkg 卸载

#

如果您使用 dpkg 安装了 Dart SDK,请使用 sudo dpkg --purge 命令。

  1. 使用 sudo dpkg --purge 命令。

    $ sudo dpkg --purge dart

    这会同时删除配置文件。

  2. 验证 SDK 已被移除。

    $ dpkg -l | grep dart

使用 Homebrew 安装

#

要安装 Dart SDK,请使用 Homebrew

  1. 如果需要,安装 Homebrew。

  2. 添加官方 tap

    $ brew tap dart-lang/dart
  3. 安装 Dart SDK。

    $ brew install dart

验证 PATH 包含 Homebrew

#

验证您的 PATH 包含 Homebrew bin 目录。设置正确的路径可以简化使用 Dart SDK 命令,例如 dart rundart format

要获得配置 PATH 的帮助,请查阅 Homebrew FAQ

使用 Homebrew 升级

#

当有新的 Dart 版本可用时进行升级

$ brew upgrade dart

切换 Dart 版本

#

要在本地安装的 Dart 版本之间切换

  1. 安装您要切换到的版本。

    例如,要安装 Dart 3.1

    $ brew install dart@3.1
  2. 要在版本之间切换,请取消链接当前版本并链接所需版本。

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

列出已安装的 Dart 版本

#

要查看您已安装的 Dart 版本

$ brew info dart

使用 Homebrew 卸载

#

要卸载 Dart SDK,请使用 Homebrew

  1. 卸载 Dart SDK。

    $ brew uninstall dart
  2. 从您的主目录中删除 Dart 配置文件。

    dart
    rm -rf  ~/.dart*

发布通道参考

#

Stable channel

#

Dart 大约每三个月在 stable channel 发布一个新版本。当前的 stable 版本是 [calculating]

使用 stable channel 版本来构建和部署生产应用程序。

Stable channel 版本字符串遵循 x.y.z 格式

  • x : 主版本
  • y : 次版本
  • z : 修补版本

stable channel 版本字符串的示例包括 1.24.32.1.0

要安装 stable channel 版本,请按照此页面上的说明进行操作。

Beta channel

#

Dart 大约每月在 beta channel 发布一个新版本。当前的 beta 版本是 [calculating]

使用 beta channel 版本来测试您的应用程序与未来 stable 版本的兼容性。

Beta channel 版本字符串遵循 x.y.z-a.b.beta 格式

  • x : 主版本
  • y : 次版本
  • z : 修补版本
  • a : 预发布版本
  • b : 预发布修补版本

beta channel 版本字符串的示例包括 2.8.0-20.11.beta3.3.0-205.1.beta

要安装 beta channel 版本,请将 SDK 下载为 zip 文件

Dev channel

#

Dart 大约每周两次在 dev channel 发布一个新版本。当前的 dev 版本是 [calculating]

使用 dev channel 版本来测试最近的修复和实验性功能。

Dev channel 版本字符串遵循 x.y.z-a.b.dev 格式

  • x : 主版本
  • y : 次版本
  • z : 修补版本
  • a : 开发版本
  • b : 开发修补版本

dev channel 版本字符串的示例包括 2.8.0-20.11.dev3.2.12-15.33.dev

要安装 dev channel 版本,请将 SDK 下载为 zip 文件