目录

获取 Dart SDK

目录

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

要了解有关 Dart SDK 的更多信息，请查阅Dart SDK 概览。

系统要求

#

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

平台x64IA32 (x86)Arm32Arm64RISC-V (RV64GC)操作系统版本
Windows已验证报告危险已验证请勿打扰10, 11
Linux已验证报告已验证已验证已验证Debian stable,
标准支持下的 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。

  • Windows
  • Linux
  • macOS

使用 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 run 和 dart format。

要获取有关配置您的 PATH 的帮助，请查阅Homebrew FAQ。

使用 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 大约每三个月会在 stable 频道发布一个新版本。当前稳定版本是 [calculating]。

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

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

  • x：主版本号
  • y：次版本号
  • z：补丁版本号

稳定频道版本字符串的示例包括 1.24.3 和 2.1.0。

要安装稳定频道版本，请按照此页面上的说明进行操作。

Beta 通道

#

Dart 大约每月会在 beta 频道发布一个新版本。当前的测试版本是 [calculating]。

使用 beta 频道版本来测试您的应用程序与未来稳定版本的兼容性。

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

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

测试频道版本字符串的示例包括 2.8.0-20.11.beta 和 3.3.0-205.1.beta。

要安装测试频道版本，请下载 ZIP 格式的 SDK。

Dev 通道

#

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

使用 dev 频道版本来测试最新的修复程序和实验性功能。

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

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

开发频道版本字符串的示例包括 2.8.0-20.11.dev 和 3.2.12-15.33.dev。

要安装开发频道版本，请下载 ZIP 格式的 SDK。

除非另有说明，否则本网站上的文档反映的是 Dart 3.6.0 版本。页面最后更新于 2024-12-14。查看源代码或报告问题。