在中國使用 Flutter

為加速在中國下載和安裝 Flutter，請考慮使用映象站點或映象。

由 China Flutter User Group (CFUG) 維護的簡體中文 Flutter 網站 https://flutter.club.tw 以及一個映象。其他映象可以在本指南的末尾找到。

要在中國安裝或使用 Flutter，請使用值得信賴的 Flutter 映象。這需要在您的機器上設定兩個環境變數。

以下所有示例都假定您正在使用 CFUG 映象。

配置您的機器以使用映象站點

此過程需要使用 Powershell。

在 Powershell 中開啟一個新視窗，準備執行指令碼。

將 PUB_HOSTED_URL 設定為您的映象站點。

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

將 FLUTTER_STORAGE_BASE_URL 設定為您的映象站點。

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

從您的映象站點下載 Flutter 歸檔檔案。在您喜歡的瀏覽器中，訪問 Flutter SDK 歸檔。
建立一個資料夾來安裝 Flutter，然後進入該資料夾。
可以考慮使用 %USERPROFILE%dev 這樣的路徑。
```
C:> New-Item -Path '`%USERPROFILE%dev`' -ItemType Directory; cd `%USERPROFILE%dev`
```
從 zip 歸檔檔案中提取 SDK。
本示例假定您下載了 Windows 版 Flutter SDK。
```
C:> Expand-Archive .\flutter_windows_3.13.0-stable.zip
```

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

C:> $env:PATH = $pwd.PATH + "/flutter/bin",$env:PATH -join ";"

執行 Flutter Doctor 來驗證您的安裝。
```
C:> flutter doctor
```

在此示例中，flutter pub get 將從 flutter-io.cn 獲取包，在您設定了 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 的任何終端中。

在此過程中使用 $env: 設定的任何環境變數僅適用於當前視窗。

要永久設定這些值，請按照以下示例設定環境變數

# cd to flutter dir
$currentDirectory = Get-Location   
$newPath = "$currentDirectory\bin;$env:PATH"
[System.Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
[System.Environment]::SetEnvironmentVariable('PUB_HOSTED_URL', 'https://pub.flutter-io.cn', 'User')
[System.Environment]::SetEnvironmentVariable('FLUTTER_STORAGE_BASE_URL', 'https://storage.flutter-io.cn', 'User')

Write-Host ". $PROFILE"

此過程需要使用您的終端。

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

將 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 歸檔檔案。在您喜歡的瀏覽器中，訪問 Flutter SDK 歸檔。
建立一個資料夾來安裝 Flutter，然後進入該資料夾。
可以考慮使用 ~/dev 這樣的路徑。
```
mkdir ~/dev; cd `~/dev`
```
從 zip 歸檔檔案中提取 SDK。
本示例假定您下載了 macOS 版 Flutter SDK。
```
unzip flutter_macos_3.13.0-stable.zip
```
將 Flutter 新增到您的 PATH 環境變數中。
```
export PATH="$PWD/flutter/bin:$PATH"
```
執行 Flutter Doctor 來驗證您的安裝。
```
flutter doctor
```

在此示例中，flutter pub get 將從 flutter-io.cn 獲取包，在您設定了 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 的任何終端中。

在此過程中使用 export 設定的任何環境變數僅適用於當前視窗。

要永久設定這些值，請將這三個 export 命令追加到您喜歡的 shell 所使用的 *rc 或 *profile 檔案中。這會類似於以下內容

cat &#x3C;<eot>> ~/.zprofile
export PUB_HOSTED_URL="https://pub.flutter-io.cn"
export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
export PATH="$PWD/flutter/bin:$PATH"
EOT

此過程需要使用您的終端。

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

將 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 歸檔檔案。在您喜歡的瀏覽器中，訪問 Flutter SDK 歸檔。
建立一個資料夾來安裝 Flutter，然後進入該資料夾。
可以考慮使用 ~/dev 這樣的路徑。
```
mkdir ~/dev; cd `~/dev`
```
從 tar.xz 歸檔檔案中提取 SDK。
本示例假定您下載了 Linux 版 Flutter SDK。
```
tar -xf flutter_linux_3.13.0-stable.tar.xz
```
將 Flutter 新增到您的 PATH 環境變數中。
```
export PATH="$PWD/flutter/bin:$PATH"
```
執行 Flutter Doctor 來驗證您的安裝。
```
flutter doctor
```

在此示例中，flutter pub get 將從 flutter-io.cn 獲取包，在您設定了 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 的任何終端中。

在此過程中使用 export 設定的任何環境變數僅適用於當前視窗。

要永久設定這些值，請將這三個 export 命令追加到您喜歡的 shell 所使用的 *rc 或 *profile 檔案中。這會類似於以下內容

cat &#x3C;<eot>> ~/.zprofile
export PUB_HOSTED_URL="https://pub.flutter-io.cn"
export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
export PATH="$PWD/flutter/bin:$PATH"
EOT

此過程需要使用您的終端。

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

將 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 歸檔檔案。在您喜歡的瀏覽器中，訪問 Flutter SDK 歸檔。
建立一個資料夾來安裝 Flutter，然後進入該資料夾。
可以考慮使用 ~/dev 這樣的路徑。
```
mkdir ~/dev; cd `~/dev`
```
從 tar.xz 歸檔檔案中提取 SDK。
本示例假定您下載了 ChromeOS 版 Flutter SDK。
```
tar -xf flutter_linux_3.13.0-stable.tar.xz
```
將 Flutter 新增到您的 PATH 環境變數中。
```
export PATH="$PWD/flutter/bin:$PATH"
```
執行 Flutter Doctor 來驗證您的安裝。
```
flutter doctor
```

在此示例中，flutter pub get 將從 flutter-io.cn 獲取包，在您設定了 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 的任何終端中。

在此過程中使用 export 設定的任何環境變數僅適用於當前視窗。

要永久設定這些值，請將這三個 export 命令追加到您喜歡的 shell 所使用的 *rc 或 *profile 檔案中。這會類似於以下內容

cat &#x3C;<eot>> ~/.zprofile
export PUB_HOSTED_URL="https://pub.flutter-io.cn"
export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
export PATH="$PWD/flutter/bin:$PATH"
EOT

要從 SDK 歸檔中的映象下載 Flutter，請將 storage.googleapis.com 替換為您信任的映象的 URL。在瀏覽器或其他應用程式（如 IDM 或 Thunder）中使用您的映象站點。這應該會提高下載速度。

以下示例顯示瞭如何將 Flutter 下載站點從 Google 的歸檔更改為 CFUG 的映象。

要下載 Flutter SDK 的 Windows 3.13 版本，您將把原始 URL 從

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

更改為映象 URL

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

要下載 Flutter SDK 的 macOS 3.13 版本，您將把原始 URL 從

https://storage.googleapis.com/flutter_infra_release/releases/stable/macos/flutter_macos_3.13.0-stable.zip

更改為映象 URL

https://storage.flutter-io.cn/flutter_infra_release/releases/stable/macos/flutter_macos_3.13.0-stable.zip

要下載 Flutter SDK 的 Linux 3.13 版本，您將把原始 URL 從

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

更改為映象 URL

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

要下載 Flutter SDK 的 ChromeOS 3.13 版本，您將把原始 URL 從

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

更改為映象 URL

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

要將您的包釋出到 pub.dev，您需要能夠同時訪問 Google Auth 和 pub.dev 站點。

啟用對 pub.dev 的訪問

配置代理。要配置代理，請檢視 Dart 關於代理的文件。
驗證您的 PUB_HOSTED_URL 環境變數是否未設定或為空。
```
echo $env:PUB_HOSTED_URL
```
如果此命令返回任何值，請將其取消設定。
```
Remove-Item $env:PUB_HOSTED_URL
```

配置代理。要配置代理，請檢視 Dart 關於代理的文件。
驗證您的 PUB_HOSTED_URL 環境變數是否未設定或為空。
```
echo $PUB_HOSTED_URL
```
如果此命令返回任何值，請將其取消設定。
```
unset $PUB_HOSTED_URL
```

配置代理。要配置代理，請檢視 Dart 關於代理的文件。
驗證您的 PUB_HOSTED_URL 環境變數是否未設定或為空。
```
echo $PUB_HOSTED_URL
```
如果此命令返回任何值，請將其取消設定。
```
unset $PUB_HOSTED_URL
```

配置代理。要配置代理，請檢視 Dart 關於代理的文件。
驗證您的 PUB_HOSTED_URL 環境變數是否未設定或為空。
```
echo $PUB_HOSTED_URL
```
如果此命令返回任何值，請將其取消設定。
```
unset $PUB_HOSTED_URL
```

要了解有關釋出包的更多資訊，請參閱 Dart 關於釋出包的文件。

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 映象時遇到僅發生的問題，請在其問題跟蹤器中報告該問題。

上海交通大學 *nix 使用者組維護著 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 映象時遇到僅發生的問題，請在其問題跟蹤器中報告該問題。

清華大學 TUNA 協會維護著 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 以獲得幫助。

此頁面內容有幫助嗎？

感謝你的反饋！

提供詳情

感謝你的反饋！請告訴我們如何改進。

提供詳情

除非另有說明，否則本網站上的文件反映了 Flutter 的最新穩定版本。頁面最後更新時間為 2025-08-25。檢視原始檔或報告問題。

使用 Flutter 映象站點

配置您的機器以使用映象站點

基於映象站點下載 Flutter 歸檔檔案

配置您的機器以釋出您的包

已知、受信任的社群執行的映象站點

China Flutter User Group

配置您的機器以使用此映象

獲取此映象的支援

上海交通大學 *nix 使用者組

配置您的機器以使用此映象

獲取此映象的支援

清華大學 TUNA 協會

配置您的機器以使用此映象

獲取此映象的支援

提供託管新的映象站點