跳至主要內容
目錄

取得 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 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 常見問題。

使用 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*

發布管道參考

#

穩定管道

#

Dart 大約每三個月向 stable 管道發布新版本。目前的穩定版本為 [calculating]。

使用 stable 管道版本來建置和部署正式版應用程式。

Stable 管道發布版本字串遵循 x.y.z 格式

  • x：主要版本
  • y：次要版本
  • z：修補程式版本

穩定管道版本字串範例包括 1.24.3 和 2.1.0。

若要安裝穩定管道版本，請依照本頁上的指示操作。

Beta 管道

#

Dart 大約每月向 beta 管道發布新版本。目前的 Beta 版本為 [calculating]。

使用 beta 管道版本來測試您的應用程式與未來穩定版本的相容性。

Beta 管道發布版本字串遵循 x.y.z-a.b.beta 格式

  • x：主要版本
  • y：次要版本
  • z：修補程式版本
  • a：預先發布版本
  • b：預先發布修補程式版本

Beta 管道版本字串範例包括 2.8.0-20.11.beta 和 3.3.0-205.1.beta。

若要安裝 Beta 管道版本，請下載 SDK 作為 zip 檔案。

Dev 管道

#

Dart 大約每週兩次向 dev 管道發布新版本。目前的 Dev 版本為 [calculating]。

使用 dev 管道版本來測試最近的修正和實驗性功能。

Dev 管道發布版本字串遵循 x.y.z-a.b.dev 格式

  • x：主要版本
  • y：次要版本
  • z：修補程式版本
  • a：開發版本
  • b：開發修補程式版本

Dev 管道版本字串範例包括 2.8.0-20.11.dev 和 3.2.12-15.33.dev。

若要安裝 Dev 管道版本，請下載 SDK 作為 zip 檔案。

除非另有說明，否則本網站上的文件反映 Dart 3.7.1。頁面上次更新於 2025-03-03。 查看原始碼 或 回報問題。