内容

获取 Dart SDK

内容

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

要了解有关 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 版本中删除。
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 常见问题解答。

使用 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 每三个月左右就会向 稳定 渠道发布新版本。当前稳定版本为 [计算中]。

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

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

  • x：主版本
  • y：次版本
  • z：修订版本

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

要安装稳定渠道版本，请按照 本页上的说明 操作。

Beta 渠道

#

Dart 每月大约会向 测试 渠道发布新版本。当前测试版本为 [计算中]。

使用 **测试** 渠道版本测试您的应用与未来稳定版本的兼容性。

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

  • x：主版本
  • y：次版本
  • z：修订版本
  • a：预发布版本
  • b：预发布修订版本

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

要安装测试渠道版本，请下载 SDK 压缩文件。

开发渠道

#

Dart 每周大约会向 开发 渠道发布两次新版本。当前开发版本为 [计算中]。

使用 **开发** 渠道版本测试最新的修复程序和实验性功能。

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

  • x：主版本
  • y：次版本
  • z：修订版本
  • a：开发版本
  • b：开发修订版本

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

要安装开发渠道版本，请下载 SDK 压缩文件。

除非另有说明，否则本网站上的文档反映的是 Dart 3.5.3。页面上次更新于 2024-08-06。 查看源代码 或 报告问题。