在中國地區使用 Flutter

為了加快在中國地區下載與安裝 Flutter 的速度，建議使用鏡像站點或 mirror。

中國 Flutter 用戶組 (CFUG) 維護了一個簡體中文的 Flutter 網站 https://flutter.cn 及其鏡像。其他鏡像站點可在本指南末尾找到。

若要在中國地區安裝或使用 Flutter，請選擇一個可信賴的 Flutter 鏡像站點。這需要在您的機器上設定兩個環境變數。

以下所有範例皆假設您使用的是 CFUG 鏡像站點。

將您的機器設定為使用鏡像站點：

這些步驟需要使用 PowerShell。

開啟一個新的 PowerShell 視窗，以準備執行 Shell 指令。

將 PUB_HOSTED_URL 設定為您的鏡像站點。

$env:PUB_HOSTED_URL="https://pub.flutter-io.cn"

將 FLUTTER_STORAGE_BASE_URL 設定為你的鏡像站點。

$env:FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

從你偏好的鏡像站點下載 Flutter 壓縮檔。
若使用 CFUG，請前往他們的 Flutter SDK archive，並下載適用於你作業平台與架構的 SDK。
建立一個用來安裝 Flutter 的資料夾，然後切換到該目錄。可以考慮使用像是 $env:USERPROFILE\dev 這樣的路徑。
```
New-Item -Path "$env:USERPROFILE\dev" -ItemType Directory; cd "$env:USERPROFILE\dev"
```
從 zip 壓縮檔案中解壓縮 SDK。
本範例假設你下載的是 Windows 版本的 Flutter SDK。你需要將壓縮檔案的路徑替換為你實際下載的檔案路徑及版本。
```
Expand-Archive .\flutter_windows_3.35.5-stable.zip
```

將 Flutter 新增到您的 PATH 環境變數中。

$env:PATH = $pwd.PATH + "\flutter\bin",$env:PATH -join ";"

開始使用 Flutter 進行開發。
完成以下步驟後， Flutter 會在目前的終端機視窗中，從 flutter-io.cn 取得套件與相關檔案。
若要讓這些設定在所有終端機永久生效，請依照將 Flutter 加入 PATH的說明操作，並同時加入 PUB_HOSTED_URL 與 FLUTTER_STORAGE_BASE_URL 變數。

在終端機中開啟一個新視窗，以準備執行 shell 指令。

將 PUB_HOSTED_URL 設定為你的鏡像站點。

export PUB_HOSTED_URL="https://pub.flutter-io.cn"

將 FLUTTER_STORAGE_BASE_URL 設定為你的鏡像站點。

export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

從您偏好的鏡像站點下載 Flutter 壓縮檔。
若使用 CFUG，請造訪他們的 Flutter SDK archive，並下載適用於您平台與架構的 SDK。
建立一個資料夾以安裝 Flutter，然後切換到該資料夾。可以考慮使用像是 ~/dev 這樣的路徑。
```
mkdir ~/dev; cd ~/dev
```
從壓縮檔（zip archive file）中解壓縮 SDK。
本範例假設你下載的是 macOS 版本的 Flutter SDK。你需要將路徑替換為你實際下載的壓縮檔案及其版本的路徑。
```
unzip flutter_macos_3.35.5-stable.zip
```
將 Flutter 新增到您的 PATH 環境變數中。
```
export PATH="$PWD/flutter/bin:$PATH"
```
開始使用 Flutter 進行開發。
完成以下步驟後， Flutter 會在目前的終端機視窗中，從 flutter-io.cn 取得套件與相關檔案。
若要在所有終端機視窗中永久設定這些值，請依照將 Flutter 加入 PATH的說明操作，並同時加入 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 變數。

在終端機中開啟一個新視窗，準備執行 Shell 指令。

將 PUB_HOSTED_URL 設定為你的鏡像站點。

export PUB_HOSTED_URL="https://pub.flutter-io.cn"

將 FLUTTER_STORAGE_BASE_URL 設定為你的鏡像站點。

export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

從您偏好的鏡像站點下載 Flutter 壓縮檔。
若使用 CFUG，請前往他們的 Flutter SDK archive，並下載適用於您平台與架構的 SDK。
建立一個資料夾以安裝 Flutter，然後切換到該資料夾。可以考慮使用像是 ~/dev 這樣的路徑。
```
mkdir ~/dev; cd ~/dev
```
從壓縮檔（tar archive file）中解壓縮 SDK。
此範例假設你下載的是 Linux 版本的 Flutter SDK（Flutter 軟體開發套件）。你需要將路徑替換為你實際下載的壓縮檔案及其版本的路徑。
```
tar -xf flutter_linux_3.35.5-stable.tar.xz
```
將 Flutter 新增到您的 PATH 環境變數中。
```
export PATH="$PWD/flutter/bin:$PATH"
```
開始使用 Flutter 進行開發。
完成以下步驟後， Flutter 會在目前的終端機視窗中，從 flutter-io.cn 取得套件與相關檔案。
若要讓這些設定在所有終端機視窗中永久生效，請依照將 Flutter 加入 PATH的說明操作，並同時加入 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 這兩個變數。

若要從鏡像站點下載 Flutter 的 SDK archive，請將 storage.googleapis.com 替換為您信任的鏡像站點 URL。您可以在瀏覽器或其他應用程式（如 IDM 或迅雷）中使用您的鏡像站點，這樣可以提升下載速度。

以下範例說明如何將 Flutter 下載站點的 URL 從 Google 的官方檔案庫更改為 CFUG 的鏡像站。

若要下載 Flutter SDK 的 x64 Windows 版本，您需要將原始的 URL 從：

https://storage.googleapis.com/flutter_infra_release/releases/stable/windows/flutter_windows_3.35.5-stable.zip

到鏡像站的 URL：

https://storage.flutter-io.cn/flutter_infra_release/releases/stable/windows/flutter_windows_3.35.5-stable.zip

若要下載適用於 arm64 架構的 macOS 版本 Flutter SDK（Flutter 軟體開發套件），您需要將原始的 URL 由：

https://storage.googleapis.com/flutter_infra_release/releases/stable/macos/flutter_macos_arm64_3.35.5-stable.zip

到鏡像 URL：

https://storage.flutter-io.cn/flutter_infra_release/releases/stable/macos/flutter_macos_arm64_3.35.5-stable.zip

若要下載 Flutter SDK（Flutter 軟體開發套件）的 Linux 版本，您需要將原始的 URL 進行如下更改：

https://storage.googleapis.com/flutter_infra_release/releases/stable/linux/flutter_linux_3.35.5-stable.tar.xz

至鏡像 URL：

https://storage.flutter-io.cn/flutter_infra_release/releases/stable/linux/flutter_linux_3.35.5-stable.tar.xz

若要將您的套件發佈到pub.dev，您需要能夠存取 Google Auth 以及pub.dev網站。

要啟用對pub.dev的存取：

設定代理伺服器（proxy）。如需設定代理伺服器，請參考 Dart documentation on proxies。
請確認您的PUB_HOSTED_URL環境變數未設定或為空值。
```
echo $env:PUB_HOSTED_URL
```
如果此指令回傳任何值，請將其取消設定（unset）。
```
Remove-Item $env:PUB_HOSTED_URL
```

設定代理伺服器。如需設定代理伺服器，請參考 Dart documentation on proxies。
請確認您的 PUB_HOSTED_URL 環境變數沒有被設定或為空值。
```
echo $PUB_HOSTED_URL
```
如果此指令有回傳任何值，請將其取消設定（unset）。
```
unset $PUB_HOSTED_URL
```

設定代理伺服器。如需設定代理伺服器，請參考 Dart documentation on proxies。
請確認您的 PUB_HOSTED_URL 環境變數尚未設定或為空值。
```
echo $PUB_HOSTED_URL
```
如果此指令有回傳任何值，請將其取消設定（unset）。
```
unset $PUB_HOSTED_URL
```

想進一步瞭解如何發佈套件，請參考 Dart documentation on publishing packages。

Flutter 團隊無法保證任何鏡像站點的長期可用性。如果有其他鏡像站點出現，您也可以選擇使用。

China Flutter User Group 維護 flutter-io.cn 鏡像站點。該鏡像包含 Flutter SDK 及 pub 套件。

若要讓您的機器使用此鏡像，請執行下列指令。

在 macOS、Linux 或 ChromeOS 上：

export PUB_HOSTED_URL=https://pub.flutter-io.cn;
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

在 Windows 上：

$env:PUB_HOSTED_URL="https://pub.flutter-io.cn";
$env:FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

如果你在使用 flutter-io.cn 鏡像時遇到僅發生於該鏡像的問題，請至他們的 issue tracker 回報問題。

Shanghai Jiao Tong University *nix User Group 維護 mirror.sjtu.edu.cn 鏡像站點。該鏡像包含 Flutter SDK 及 pub 套件。

若要讓您的機器使用此鏡像，請執行下列指令。

在 macOS、Linux 或 ChromeOS 上：

export PUB_HOSTED_URL=https://mirror.sjtu.edu.cn/dart-pub;
export FLUTTER_STORAGE_BASE_URL=https://mirror.sjtu.edu.cn

在 Windows 上：

$env:PUB_HOSTED_URL="https://mirror.sjtu.edu.cn/dart-pub";
$env:FLUTTER_STORAGE_BASE_URL="https://mirror.sjtu.edu.cn"

如果你在使用 mirror.sjtu.edu.cn 鏡像時遇到僅發生於該鏡像的問題，請至他們的 issue tracker 回報問題。

Tsinghua University TUNA Association 維護 mirrors.tuna.tsinghua.edu.cn 鏡像站點。該鏡像包含 Flutter SDK 及 pub 套件。

若要讓您的機器使用此鏡像，請執行下列指令。

在 macOS、Linux 或 ChromeOS 上：

export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub;
export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter

在 Windows 上：

$env:PUB_HOSTED_URL="https://mirrors.tuna.tsinghua.edu.cn/dart-pub";
$env:FLUTTER_STORAGE_BASE_URL="https://mirrors.tuna.tsinghua.edu.cn/flutter"

如果你在使用 mirrors.tuna.tsinghua.edu.cn 鏡像時遇到僅發生於該鏡像的問題，請至他們的 issue tracker 回報問題。

如果你有興趣架設自己的鏡像站，請聯絡 flutter-dev@googlegroups.com 以獲得協助。

此頁面的內容是否對您有幫助？

感謝您的回饋！

提供詳細內容

感謝您的回饋！請告訴我們可以如何改進。

提供詳細內容

除非另有說明，本網站上的文件反映最新的 Flutter 穩定版。頁面最後更新於 2025-10-26。檢視原始碼或回報問題.

在中國地區使用 Flutter

使用 Flutter 鏡像站點

設定您的機器以使用鏡像站點

透過鏡像站點下載 Flutter 壓縮檔

設定您的機器以發佈套件

已知且受信任的社群運營鏡像站點

China Flutter User Group

設定您的機器使用此鏡像

取得此鏡像的支援

Shanghai Jiao Tong University *nix User Group

設定您的機器使用此鏡像

取得此鏡像的支援

Tsinghua University TUNA Association

設定您的機器使用此鏡像

取得此鏡像的支援

提供新鏡像站點的申請