將 Flutter 加入 PATH

了解如何在下載 Flutter SDK 後，將 Flutter 加入你的 PATH。

了解如何在下載 SDK 後，將 Flutter 加入你的 PATH 環境變數。將 Flutter 加入你的 PATH，即可在終端機與 IDE 中使用 flutter 和 dart 命令列工具。

Windows

在 Windows 上將 Flutter 加入你的 path。

macOS

在 macOS 上將 Flutter 加入你的 path。

Linux

在 Linux 上將 Flutter 加入你的 path。

ChromeOS

在 ChromeOS 上將 Flutter 加入你的 path。

若要在 Windows 的終端機中執行 flutter 和 dart 指令，請將 Flutter SDK 的 bin 目錄加入 Path 環境變數。

確認 Flutter SDK 安裝位置
複製您下載並解壓縮 Flutter SDK 的目錄之絕對路徑。
前往環境變數設定
1. 按下 Windows + Pause。
  若您的鍵盤沒有 Pause 鍵，請嘗試 Windows + Fn + B。
  System > About 對話方塊會開啟。
2. 點擊 Advanced System Settings > Advanced > Environment Variables...。
  Environment Variables 對話方塊會開啟。
將 Flutter SDK bin 加入您的路徑
1. 在 Environment Variables 對話方塊的 User variables for (username) 區段中，尋找 Path 項目。
2. 若 Path 項目已存在，請雙擊它。
  Edit Environment Variable 對話方塊應會開啟。
  1. 雙擊空白列。
  2. 輸入 Flutter 安裝目錄中 bin 資料夾的路徑。
    舉例來說，若您將 Flutter 下載到使用者目錄下的 develop\flutter 資料夾，請輸入以下內容：
    %USERPROFILE%\develop\flutter\bin
  3. 點擊您剛新增的 Flutter 項目以選取它。
  4. 點擊 Move Up，直到 Flutter 項目移至清單頂端。
  5. 若要確認變更，請點擊 OK 三次。
3. 若項目不存在，請點擊 New...。
  Edit Environment Variable 對話方塊應會開啟。
  1. 在 Variable Name 欄位中輸入 Path。
  2. 在 Variable Value 欄位中，輸入 Flutter 安裝目錄中 bin 資料夾的路徑。
    舉例來說，若您將 Flutter 下載到使用者目錄下的 develop\flutter 資料夾，請輸入以下內容：
    %USERPROFILE%\develop\flutter\bin
  3. 若要確認變更，請點擊 OK 三次。
套用變更
若要套用此變更並取得 flutter 工具的存取權，請關閉並重新開啟所有已開啟的命令提示字元、終端機應用程式中的工作階段，以及 IDE。
驗證設定
若要確認您已成功將 SDK 新增至 PATH，請開啟命令提示字元或您偏好的終端機應用程式，然後嘗試執行 flutter 和 dart 工具。
```
$ flutter --version
$ dart --version
```
若任一指令找不到，請參閱 Flutter 安裝疑難排解。

若要在 macOS 的終端機中執行 flutter 和 dart 指令，請將 Flutter SDK 的 bin 目錄加入 PATH 環境變數。

確認 Flutter SDK 安裝位置
複製你下載並解壓縮 Flutter SDK 的目錄絕對路徑。
開啟或建立 Zsh 環境變數檔
若檔案已存在，請用你慣用的文字編輯器開啟 Zsh 環境變數檔 ~/.zprofile。若檔案不存在，請建立 ~/.zprofile 檔案。
將 Flutter SDK bin 加入你的 PATH
在 ~/.zprofile 檔案末尾，使用內建的 export 指令更新 PATH 變數，將 Flutter 安裝目錄下的 bin 目錄包含進來。
請將 <path-to-sdk> 替換為你的 Flutter SDK 安裝路徑。
bash
```
export PATH="<path-to-sdk>/bin:$PATH"
```
例如，若你將 Flutter 下載到使用者目錄內的 develop/flutter 資料夾，則需在檔案中加入以下內容：
bash
```
export PATH="$HOME/develop/flutter/bin:$PATH"
```
儲存變更
儲存並關閉你編輯的 ~/.zprofile 檔案。
套用變更
若要套用此變更並取得 flutter 工具的存取權，請關閉並重新開啟終端機應用程式及 IDE 中所有已開啟的 Zsh 工作階段。
驗證設定
為確認你已成功將 SDK 加入 PATH，請在慣用的終端機中開啟一個 Zsh 工作階段，然後嘗試執行 flutter 和 dart 工具。
```
$ flutter --version
$ dart --version
```
若任一指令找不到，請參閱 Flutter 安裝疑難排解。

若要在 Linux 的終端機中執行 flutter 和 dart 指令，請將 Flutter SDK 的 bin 目錄加入 PATH 環境變數。

確認 Flutter SDK 安裝位置
複製你下載並解壓縮 Flutter SDK 的目錄之絕對路徑。
確認預設 shell
如果你不確定使用哪種 shell，請開啟新的終端機視窗，確認啟動的是哪種 shell。
```
$ echo $SHELL
```
將 Flutter SDK bin 加入 PATH
要將 Flutter 安裝目錄下的 bin 目錄加入 PATH：
1. 展開符合你預設 shell 的說明。
2. 複製所提供的指令。
3. 將 <path-to-sdk> 替換成你的 Flutter SDK 安裝路徑。
4. 在你偏好的終端機中，以該 shell 執行修改後的指令。
展開 bash 說明
```
$ echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.bashrc
```
舉例來說，如果你將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾，請執行以下指令：
```
$ echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bashrc
```
展開 zsh 說明
```
$ echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.zshenv
```
舉例來說，如果你將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾，請執行以下指令：
```
$ echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.zshenv
```
展開 fish 說明
```
$ fish_add_path -g -p <path-to-sdk>/bin
```
舉例來說，如果你將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾，請執行以下指令：
```
$ fish_add_path -g -p ~/develop/flutter/bin
```
展開 csh 說明
```
$ echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.cshrc
```
舉例來說，如果你將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾，請執行以下指令：
```
$ echo 'setenv PATH "$HOME/develop/flutter/bin:$PATH"' >> ~/.cshrc
```
展開 tcsh 說明
```
$ echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.tcshrc
```
舉例來說，如果你將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾，請執行以下指令：
```
$ echo 'setenv PATH "$HOME/develop/flutter/bin:$PATH"' >> ~/.tcshrc
```
展開 ksh 說明
```
$ echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile
```
舉例來說，如果你將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾，請執行以下指令：
```
$ echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.profile
```
展開 sh 說明
```
$ echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile
```
舉例來說，如果你將 Flutter 下載到使用者目錄下的 develop/flutter 資料夾，請執行以下指令：
```
$ echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.profile
```
套用變更
要套用此變更並存取 flutter 工具，請關閉並重新開啟終端機應用程式和 IDE 中所有已開啟的 shell 工作階段。
驗證設定
為確認你已成功將 SDK 加入 PATH，請以預設 shell 開啟你偏好的終端機，然後嘗試執行 flutter 和 dart 工具。
```
$ flutter --version
$ dart --version
```
如果其中任一指令找不到，請參閱 Flutter 安裝疑難排解。

若要在 ChromeOS 的終端機中執行 flutter 和 dart 指令，請將 Flutter SDK 的 bin 目錄加入 PATH 環境變數。

確認你的 Flutter SDK 安裝位置
複製你下載並解壓縮 Flutter SDK 的目錄絕對路徑。
將 Flutter SDK 的 bin 目錄加入路徑
若要將 Flutter 安裝目錄的 bin 資料夾加入 PATH：
1. 複製以下指令。
2. 將 <path-to-sdk> 替換為你的 Flutter SDK 安裝路徑。
3. 在慣用的終端機中執行修改後的指令。
```
$ echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile
```
例如，若你將 Flutter 下載至使用者目錄下的 develop/flutter 資料夾，則需執行以下指令：
```
$ echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bash_profile
```
套用變更
若要套用此變更並取得 flutter 工具的存取權，請關閉並重新開啟終端機應用程式與 IDE 中所有已開啟的 Zsh 工作階段。
驗證設定
若要確認你已成功將 SDK 加入 PATH，請在慣用的終端機中開啟 Zsh 工作階段，然後嘗試執行 flutter 與 dart 工具。
```
$ flutter --version
$ dart --version
```
若找不到上述任一指令，請參閱 Flutter 安裝疑難排解。

Was this page's content helpful?

Unless stated otherwise, the documentation on this site reflects Flutter 3.44.0. Page last updated on 2026-06-14. View source or report an issue.

Windows

確認 Flutter SDK 安裝位置

前往環境變數設定

將 Flutter SDK bin 加入您的路徑

套用變更

驗證設定

macOS

確認 Flutter SDK 安裝位置

開啟或建立 Zsh 環境變數檔

將 Flutter SDK bin 加入你的 PATH

儲存變更

套用變更

驗證設定

Linux

確認 Flutter SDK 安裝位置

確認預設 shell

將 Flutter SDK bin 加入 PATH

套用變更

驗證設定

ChromeOS

確認你的 Flutter SDK 安裝位置

將 Flutter SDK 的 bin 目錄加入路徑

套用變更

驗證設定