在中国使用 Flutter

为了加速在中国下载和安装 Flutter，请考虑使用镜像站点或镜像。

中国 Flutter 用户组 (CFUG) 维护着一个简体中文的 Flutter 网站 https://fluttercn.cn 和一个镜像。其他镜像可以在本指南末尾找到。

要在中国安装或使用 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、迅雷等其他应用程序中使用您的镜像站点。这应该会提高下载速度。

以下示例展示了如何将 Flutter 的下载站点 URL 从 Google 的归档更改为 CFUG 的镜像。

要下载 Windows 3.13 版本的 Flutter SDK，您需要将原始 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

要下载 macOS 3.13 版本的 Flutter SDK，您需要将原始 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

要下载 Linux 3.13 版本的 Flutter SDK，您需要将原始 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

要下载 ChromeOS 3.13 版本的 Flutter SDK，您需要将原始 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 团队无法保证任何镜像的长期可用性。如果其他镜像可用，您可以使用它们。

中国 Flutter 用户组维护着 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-05-14。查看源代码或报告问题。

使用 Flutter 镜像站点

配置您的机器以使用镜像站点

基于镜像站点下载 Flutter 归档文件

配置您的机器以发布软件包

已知且可信的社区维护镜像站点

中国 Flutter 用户组

配置您的机器以使用此镜像

获取此镜像的支持

上海交通大学 *nix 用户组

配置您的机器以使用此镜像

获取此镜像的支持

清华大学 TUNA 协会

配置您的机器以使用此镜像

获取此镜像的支持

提供托管新的镜像站点