瞭解如何手動安裝和設定 Flutter 開發環境。

選擇你的開發平臺

#

此頁面上的說明配置為涵蓋在 Windows 裝置上安裝 Flutter。

如果你想遵循其他作業系統的說明,請選擇以下之一。

下載先決軟體

#

在安裝 Flutter SDK 之前,請先完成以下設定。

  1. 安裝適用於 Windows 的 Git

    下載並安裝最新版適用於 Windows 的 Git

    有關安裝或故障排除 Git 的幫助,請參閱 Git 文件

  2. 設定編輯器或 IDE

    為了獲得最佳的 Flutter 應用開發體驗,請考慮安裝並設定一個支援 Flutter 的編輯器或 IDE

  1. 安裝 Xcode 命令列工具

    下載 Xcode 命令列工具以訪問 Flutter 依賴的命令列工具,包括 Git。

    要下載這些工具,請在你喜歡的終端中執行以下命令

    xcode-select --install

    如果你尚未安裝這些工具,將彈出一個對話方塊,確認你是否要安裝它們。單擊 安裝,安裝完成後,單擊 完成

  2. 設定編輯器或 IDE

    為了獲得最佳的 Flutter 應用開發體驗,請考慮安裝並設定一個支援 Flutter 的編輯器或 IDE

  1. 下載並安裝先決軟體包

    使用你偏好的包管理器或機制,安裝以下軟體包的最新版本

    • curl
    • git
    • unzip
    • xz-utils
    • zip
    • libglu1-mesa

    在基於 Debian 的發行版(如 Ubuntu)上,使用 apt-get,請使用以下命令安裝這些軟體包

    sudo apt-get update -y && sudo apt-get upgrade -y
    sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
  2. 設定編輯器或 IDE

    為了獲得最佳的 Flutter 應用開發體驗,請考慮安裝並設定一個支援 Flutter 的編輯器或 IDE

  1. 設定 Linux 支援

    如果你之前未在 Chromebook 上設定 Linux 支援,請開啟 Linux 支援

    如果你已經開啟了 Linux 支援,請按照解決 Linux 問題的說明進行更新。

  2. 下載並安裝先決軟體包

    使用 apt-get 或你喜歡的安裝機制,安裝以下軟體包的最新版本

    • curl
    • git
    • unzip
    • xz-utils
    • zip
    • libglu1-mesa

    如果你想使用 apt-get,請使用以下命令安裝這些軟體包

    sudo apt-get update -y && sudo apt-get upgrade -y
    sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
  3. 設定編輯器或 IDE

    為了獲得最佳的 Flutter 應用開發體驗,請考慮安裝並設定一個支援 Flutter 的編輯器或 IDE

安裝並設定 Flutter

#

要安裝 Flutter SDK,請從 SDK 歸檔檔案中下載最新捆綁包,然後將 SDK 解壓縮到你想要儲存它的位置。

  1. 下載 Flutter SDK 捆綁包

    下載以下安裝包以獲取 Flutter SDK 的最新穩定版本。

    (載入中...)

  2. 建立用於儲存 SDK 的資料夾

    建立或找到一個用於儲存已解壓 SDK 的資料夾。考慮在 %USERPROFILE%\develop (C:\Users\{username}\develop) 建立並使用一個目錄。

  3. 解壓 SDK

    將你下載的 SDK 捆綁包解壓到你想要儲存 Flutter SDK 的目錄中。

    1. 複製以下命令。
    2. <sdk_zip_path> 替換為你下載的捆綁包的路徑。
    3. <destination_directory_path> 替換為你想要解壓 SDK 的資料夾的路徑。
    4. 在你喜歡的終端中執行編輯後的命令。
    Expand-Archive –Path <sdk_zip_path> -Destination <destination_directory_path>

    例如,如果你將 Flutter 3.29.3 的捆綁包下載到 %USERPROFILE%\Downloads 目錄,並希望將解壓後的 SDK 儲存在 %USERPROFILE%\develop 目錄中

    Expand-Archive `
      –Path $env:USERPROFILE\Downloads\flutter_windows_3.29.3-stable.zip `
      -Destination $env:USERPROFILE\develop\
  1. 下載 Flutter SDK 捆綁包

    根據你 macOS 裝置的 CPU 架構,下載以下安裝包之一以獲取 Flutter SDK 的最新穩定版本。

    Apple Silicon (ARM64)Intel (x64)
    (載入中...)(載入中...)
  2. 建立用於儲存 SDK 的資料夾

    建立或找到一個用於儲存解壓後的 SDK 的資料夾。考慮在 ~/develop/ 中建立和使用一個目錄。

  3. 解壓 SDK

    將你下載的 SDK 捆綁包解壓到你想要儲存 Flutter SDK 的目錄中。

    1. 複製以下命令。
    2. <sdk_zip_path> 替換為你下載的捆綁包的路徑。
    3. <destination_directory_path> 替換為你想要解壓 SDK 的資料夾的路徑。
    4. 在你喜歡的終端中執行編輯後的命令。
    unzip <sdk_zip_path> -d <destination_directory_path>

    例如,如果你將 Flutter 3.29.3 的捆綁包下載到 ~/Downloads 目錄,並希望將解壓後的 SDK 儲存在 ~/develop 目錄中

    unzip ~/Downloads/flutter_macos_3.29.3-stable.zip -d ~/develop/
  1. 下載 Flutter SDK 捆綁包

    下載以下安裝包以獲取 Flutter SDK 的最新穩定版本。

    (載入中...)

  2. 建立用於儲存 SDK 的資料夾

    建立或找到一個用於儲存解壓後的 SDK 的資料夾。考慮在 ~/develop/ 中建立和使用一個目錄。

  3. 解壓 SDK

    將你下載的 SDK 捆綁包解壓到你想要儲存 Flutter SDK 的目錄中。

    1. 複製以下命令。
    2. <sdk_zip_path> 替換為你下載的捆綁包的路徑。
    3. <destination_directory_path> 替換為你想要解壓 SDK 的資料夾的路徑。
    4. 在你喜歡的終端中執行編輯後的命令。
    tar -xf <sdk_zip_path> -C <destination_directory_path>

    例如,如果你將 Flutter 3.29.3 的捆綁包下載到 ~/Downloads 目錄,並希望將解壓後的 SDK 儲存在 ~/develop 目錄中

    tar -xf ~/Downloads/flutter_linux_3.29.3-stable.tar.xz -C ~/develop/

將 Flutter 新增到 PATH

#

現在你已經下載了 SDK,將 Flutter SDK 的 bin 目錄新增到你的 PATH 環境變數中。將 Flutter 新增到 PATH 允許你在終端和 IDE 中使用 flutterdart 命令列工具。

  1. 確定您的 Flutter SDK 安裝位置

    複製您下載並解壓 Flutter SDK 的目錄的絕對路徑。

  2. 導航到環境變數設定

    1. 按下 Windows + Pause

      如果您的鍵盤沒有 Pause 鍵,請嘗試 Windows + Fn + B

      將開啟 系統 > 關於 對話方塊。

    2. 單擊 高階系統設定 > 高階 > 環境變數...

      將開啟 環境變數 對話方塊。

  3. 將 Flutter SDK bin 新增到你的路徑

    1. 環境變數 對話方塊的 使用者變數(username) 部分,查詢 Path 條目。

    2. 如果 Path 條目存在,雙擊它。

      應該會開啟 編輯環境變數 對話方塊。

      1. 雙擊一個空行。

      2. 輸入 Flutter 安裝目錄的 bin 路徑。

        例如,如果你將 Flutter 下載到使用者目錄中的 develop\flutter 資料夾中,你將輸入以下內容

        %USERPROFILE%\develop\flutter\bin
      3. 單擊你新增的 Flutter 條目以將其選中。

      4. 點選上移,直到 Flutter 條目位於列表頂部。

      5. 要確認你的更改,請單擊 確定 三次。

    3. 如果該條目不存在,請點選新建...

      應該會開啟 編輯環境變數 對話方塊。

      1. 在“變數名”框中,輸入 Path

      2. 變數值 框中,輸入 Flutter 安裝目錄的 bin 路徑。

        例如,如果你將 Flutter 下載到使用者目錄中的 develop\flutter 資料夾中,你將輸入以下內容

        %USERPROFILE%\develop\flutter\bin
      3. 要確認你的更改,請單擊 確定 三次。

  4. 應用你的更改

    要應用此更改並訪問 flutter 工具,請關閉並重新開啟所有開啟的命令提示符、終端應用中的會話和 IDE。

  5. 驗證您的設定

    為確保你已成功將 SDK 新增到 PATH,請開啟命令提示符或你喜歡的終端應用,然後嘗試執行 flutterdart 工具。

    flutter --version
    dart --version

    如果找不到任何命令,請檢視Flutter 安裝故障排除

  1. 確定您的 Flutter SDK 安裝位置

    複製您下載並解壓 Flutter SDK 的目錄的絕對路徑。

  2. 開啟或建立 Zsh 環境變數檔案

    如果存在,請在你喜歡的文字編輯器中開啟 Zsh 環境變數檔案 ~/.zshenv。如果不存在,請建立 ~/.zshenv 檔案。

  3. 將 Flutter SDK bin 新增到你的路徑

    在你的 ~/.zshenv 檔案末尾,使用內建的 export 命令更新 PATH 變數,使其包含你的 Flutter 安裝目錄的 bin 目錄。

    <path-to-sdk> 替換為你的 Flutter SDK 安裝路徑。

    bash
    export PATH="<path-to-sdk>/bin:$PATH"

    例如,如果你將 Flutter 下載到使用者目錄中的 development/flutter 資料夾中,你將向檔案中新增以下內容

    bash
    export PATH="$HOME/development/flutter/bin:$PATH"
  4. 儲存你的更改

    儲存並關閉你編輯的 ~/.zshenv 檔案。

  5. 應用你的更改

    要應用此更改並訪問 flutter 工具,請關閉並重新開啟終端應用和 IDE 中所有開啟的 Zsh 會話。

  6. 驗證您的設定

    為確保你已成功將 SDK 新增到 PATH,請在你喜歡的終端中開啟 Zsh 會話,然後嘗試執行 flutterdart 工具。

    flutter --version
    dart --version

    如果找不到任何命令,請檢視Flutter 安裝故障排除

  1. 確定您的 Flutter SDK 安裝位置

    複製您下載並解壓 Flutter SDK 的目錄的絕對路徑。

  2. 確定你的預設 Shell

    如果你不知道自己使用什麼 Shell,請檢查開啟新控制檯視窗時啟動的是哪個 Shell。

    echo $SHELL
  3. 將 Flutter SDK bin 新增到你的路徑

    要將 Flutter 安裝目錄的 bin 目錄新增到你的 PATH

    1. 展開你的預設 Shell 的說明。
    2. 複製提供的命令。
    3. <path-to-sdk> 替換為你的 Flutter SDK 安裝路徑。
    4. 在你喜歡的終端中使用該 Shell 執行編輯後的命令。

    展開 bash 說明
    echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile

    例如,如果你將 Flutter 下載到使用者目錄中的 development/flutter 資料夾中,你將執行以下命令

    echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.bash_profile
    展開 zsh 說明
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.zshenv

    例如,如果你將 Flutter 下載到使用者目錄中的 development/flutter 資料夾中,你將執行以下命令

    echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.zshenv
    展開 fish 說明
    fish_add_path -g -p <path-to-sdk>/bin

    例如,如果你將 Flutter 下載到使用者目錄中的 development/flutter 資料夾中,你將執行以下命令

    fish_add_path -g -p ~/development/flutter/bin
    展開 csh 說明
    echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.cshrc

    例如,如果你將 Flutter 下載到使用者目錄中的 development/flutter 資料夾中,你將執行以下命令

    echo 'setenv PATH "$HOME/development/flutter/bin:$PATH"' >> ~/.cshrc
    展開 tcsh 說明
    echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.tcshrc

    例如,如果你將 Flutter 下載到使用者目錄中的 development/flutter 資料夾中,你將執行以下命令

    echo 'setenv PATH "$HOME/development/flutter/bin:$PATH"' >> ~/.tcshrc
    展開 ksh 說明
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile

    例如,如果你將 Flutter 下載到使用者目錄中的 development/flutter 資料夾中,你將執行以下命令

    echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.profile
    展開 sh 說明
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile

    例如,如果你將 Flutter 下載到使用者目錄中的 development/flutter 資料夾中,你將執行以下命令

    echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.profile
  4. 應用你的更改

    要應用此更改並訪問 flutter 工具,請關閉並重新開啟終端應用和 IDE 中所有開啟的 Shell 會話。

  5. 驗證您的設定

    為確保你已成功將 SDK 新增到 PATH,請在你喜歡的終端中使用你的預設 Shell,然後嘗試執行 flutterdart 工具。

    flutter --version
    dart --version

    如果找不到任何命令,請檢視Flutter 安裝故障排除

  1. 確定您的 Flutter SDK 安裝位置

    複製您下載並解壓 Flutter SDK 的目錄的絕對路徑。

  2. 將 Flutter SDK bin 新增到你的路徑

    要將 Flutter 安裝目錄的 bin 目錄新增到你的 PATH

    1. 複製以下命令。
    2. <path-to-sdk> 替換為你的 Flutter SDK 安裝路徑。
    3. 在你喜歡的終端中執行編輯後的命令。
    echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile

    例如,如果你將 Flutter 下載到使用者目錄中的 development/flutter 資料夾中,你將執行以下命令

    echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.bash_profile
  3. 應用你的更改

    要應用此更改並訪問 flutter 工具,請關閉並重新開啟終端應用和 IDE 中所有開啟的 Zsh 會話。

  4. 驗證您的設定

    為確保你已成功將 SDK 新增到 PATH,請在你喜歡的終端中開啟 Zsh 會話,然後嘗試執行 flutterdart 工具。

    flutter --version
    dart --version

    如果找不到任何命令,請檢視Flutter 安裝故障排除

繼續你的 Flutter 之旅

#

現在你已成功安裝 Flutter,請為至少一個目標平臺設定開發環境,以繼續你的 Flutter 之旅。