目录

获取 Dart SDK

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

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

系统要求

#

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

平台x64IA32 (x86)Arm32Arm64RISC-V (RV64GC)操作系统版本
Windowsverifiedreportdangerousverifieddo_not_disturb_on10, 11
LinuxverifiedreportverifiedverifiedverifiedDebian 稳定版 ,
Ubuntu LTS 标准支持版本
macOSverifieddangerousdo_not_disturb_onverifieddo_not_disturb_on最新三个版本的 macOS:
Sonoma (14), Ventura (13), Monterey (12)

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

选择安装选项

#

要从稳定版渠道安装和更新 Dart SDK,请选择以下选项之一:

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

  2. 使用 Dart Docker 镜像

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

  4. SDK 存档 下载 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
  1. 安装 Dart SDK。
$ brew install dart

验证 PATH 包含 Homebrew

#

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

要获取有关配置 PATH 的帮助,请参阅 Homebrew 常见问题解答

使用 Homebrew 升级

#

当有新的 Dart 版本发布时,请升级:

$ brew upgrade dart

切换 Dart 版本

#

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

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

    例如,要安装 Dart 3.1:

    $ brew install [email protected]
  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*

发布渠道参考

#

稳定版 渠道

#

Dart 大约每 向 稳定版 渠道发布一个新版本。当前的 稳定版 版本是 [calculating] {:.build-rev-稳定版}。

稳定版 渠道版本用于 。

稳定版 渠道发行版本的字符串遵循 格式:

  • x :主版本
  • y :次版本
  • z :修补程序版本
  • a : 版本
  • b : 修补程序版本

稳定版 渠道版本字符串的示例包括 。

要安装 稳定版 渠道版本, 请下载 SDK zip 文件

测试版 渠道

#

Dart 大约每 向 测试版 渠道发布一个新版本。当前的 测试版 版本是 [calculating] {:.build-rev-测试版}。

测试版 渠道版本用于 。

测试版 渠道发行版本的字符串遵循 格式:

  • x :主版本
  • y :次版本
  • z :修补程序版本
  • a : 版本
  • b : 修补程序版本

测试版 渠道版本字符串的示例包括 。

要安装 测试版 渠道版本, 请下载 SDK zip 文件

开发版 渠道

#

Dart 大约每 向 开发版 渠道发布一个新版本。当前的 开发版 版本是 [calculating] {:.build-rev-开发版}。

开发版 渠道版本用于 。

开发版 渠道发行版本的字符串遵循 格式:

  • x :主版本
  • y :次版本
  • z :修补程序版本
  • a : 版本
  • b : 修补程序版本

开发版 渠道版本字符串的示例包括 。

要安装 开发版 渠道版本, 请下载 SDK zip 文件