在中國地區使用 Flutter

如何在中國地區使用、存取及學習 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 壓縮檔案中解壓縮 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 壓縮檔案中解壓縮 SDK。
本範例假設您下載的是 Linux 版本的 Flutter SDK。您需要將路徑替換為您實際下載的壓縮檔案及其版本的路徑。
```
$ 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，您需要將原始的 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 的 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 鏡像站時才發生的問題，請向其問題追蹤器回報。

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 鏡像站時才發生的問題，請向其問題追蹤器回報。

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 鏡像站時才發生的問題，請向其問題追蹤器回報。

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

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.

在中國地區使用 Flutter

使用 Flutter 鏡像站點

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

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

設定您的機器以發佈套件

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

China Flutter User Group

設定您的機器使用此鏡像站

取得此鏡像站的支援

Shanghai Jiao Tong University *nix User Group

設定您的機器使用此鏡像站

取得此鏡像站的支援

Tsinghua University TUNA Association

設定您的機器使用此鏡像站

取得此鏡像站的支援

提供新鏡像站點的申請