跳到主要内容

获取 Dart SDK

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

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

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

系统要求

#

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

平台x64IA32 (x86)Arm32Arm64RISC-V (RV64GC)操作系统版本
Windows已验证危险危险已验证请勿打扰10, 11
Linux已验证危险已验证已验证已验证Debian 稳定版,
Ubuntu LTS 标准支持
macOS已验证危险请勿打扰已验证请勿打扰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
  3. 安装 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 dart@3.1
  2. 要切换版本,请取消链接当前版本并链接所需版本。

    brew unlink dart@<old> \
      &#x26;&#x26; brew unlink dart@<new> \
      &#x26;&#x26; 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 大约每三个月在稳定版渠道发布一个新版本。当前的稳定版是 [计算中]

使用稳定版渠道发布版本来构建和部署生产应用。

稳定版渠道发布版本字符串遵循 x.y.z 格式:

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

稳定版渠道版本字符串的例子包括 1.24.32.1.0

要安装稳定版渠道发布版本,请遵循本页上的说明

测试版渠道

#

Dart 大约每月在测试版渠道发布一个新版本。当前的测试版是 [计算中]

使用测试版渠道发布版本来测试你的应用与未来稳定版本的兼容性。

测试版渠道发布版本字符串遵循 x.y.z-a.b.beta 格式:

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

测试版渠道版本字符串的例子包括 2.8.0-20.11.beta3.3.0-205.1.beta

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

开发版渠道

#

Dart 大约每周两次在开发版渠道发布一个新版本。当前的开发版是 [计算中]

使用开发版渠道发布版本来测试最近的修复和实验性功能。

开发版渠道发布版本字符串遵循 x.y.z-a.b.dev 格式:

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

开发版渠道版本字符串的例子包括 2.8.0-20.11.dev3.2.12-15.33.dev

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