跳转至正文

在中国网络环境下使用 Flutter

为加快 Flutter 在中国的下载以及安装速度，请考虑使用 镜像站点 和 镜像

使用 Flutter 镜像站点

#

China Flutter User Group (CFUG) 维护着一个 Flutter 简体中文网站 https://flutter.cn 以及镜像。其他镜像可在 本文末尾 找到。

配置你的机器使用镜像站点

#

在中国安装和使用 Flutter，请使用可信的 Flutter 镜像。这需要在你的机器上设置两个环境变量。

以下所有示例均假定你正在使用 CFUG 的镜像。

设置你的机器使用镜像站点：

以下步骤需要使用 PowerShell。

  1. 在 PowerShell 中打开新窗口，准备运行 shell 命令。

  2. 将 PUB_HOSTED_URL 设置为镜像站点。

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

  3. 将 FLUTTER_STORAGE_BASE_URL 设置为镜像站点。

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

  4. 从镜像站点下载 Flutter 压缩包。

    例如：要获取 CFUG 的 Flutter SDK，请访问 Flutter SDK 归档列表，并下载适用于你的平台和架构的 SDK。

  5. 创建一个可以安装 Flutter 的文件夹，然后进入该文件夹。可以考虑类似 $env:USERPROFILE\dev 的路径。

    $ New-Item -Path "$env:USERPROFILE\dev" -ItemType Directory; cd "$env:USERPROFILE\dev"

  6. 从 zip 压缩文件中解压提取 SDK。

    本示例假定你下载了 Windows 版本的 Flutter SDK。你需要将以下路径替换为你下载的文件及其版本的路径。

    $ Expand-Archive .\flutter_windows_3.35.5-stable.zip

  7. 将 Flutter 添加到你的 PATH 环境变量中。

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

  8. 开始使用 Flutter 进行开发。

    完成上述步骤后， Flutter 将在当前终端窗口中，从 flutter-io.cn 获取 package 和构建产物。

    要在所有终端上永久设置这些值，请按照说明将 Flutter 添加到 PATH 环境变量，同时还需要添加 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 环境变量。

  1. 在终端中打开新窗口，准备运行 shell 命令。

  2. 将 PUB_HOSTED_URL 设置为镜像站点。

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

  3. 将 FLUTTER_STORAGE_BASE_URL 设置为镜像站点。

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

  4. 从镜像站点下载 Flutter 压缩包。

    例如：要获取 CFUG 的 Flutter SDK，请访问 Flutter SDK 归档列表，并下载适用于你的平台和架构的 SDK。

  5. 创建一个可以安装 Flutter 的文件夹，然后进入该文件夹。可以考虑类似 ~/dev 的路径。

    $ mkdir ~/dev; cd ~/dev

  6. 从 zip 压缩文件中解压提取 SDK。

    本示例假定你下载了 macOS 版本的 Flutter SDK。你需要将以下路径替换为你下载的文件及其版本的路径。

    $ unzip flutter_macos_3.35.5-stable.zip

  7. 将 Flutter 添加到你的 PATH 环境变量中。

    $ export PATH="$PWD/flutter/bin:$PATH"

  8. 开始使用 Flutter 进行开发。

    完成上述步骤后， Flutter 将在当前终端窗口中，从 flutter-io.cn 获取 package 和构建产物。

    要在所有终端上永久设置这些值，请按照说明将 Flutter 添加到 PATH 环境变量，同时还需要添加 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 环境变量。

  1. 在终端中打开新窗口，准备运行 shell 命令。

  2. 将 PUB_HOSTED_URL 设置为镜像站点。

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

  3. 将 FLUTTER_STORAGE_BASE_URL 设置为镜像站点。

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

  4. 从镜像站点下载 Flutter 压缩包。

    例如：要获取 CFUG 的 Flutter SDK，请访问 Flutter SDK 归档列表，并下载适用于你的平台和架构的 SDK。

  5. 创建一个可以安装 Flutter 的文件夹，然后进入该文件夹。可以考虑类似 ~/dev 的路径。

    $ mkdir ~/dev; cd ~/dev

  6. 从 tar 压缩文件中解压提取 SDK。

    本示例假定你下载了 Linux 版本的 Flutter SDK。你需要将以下路径替换为你下载的文件及其版本的路径。

    $ tar -xf flutter_linux_3.35.5-stable.tar.xz

  7. 将 Flutter 添加到你的 PATH 环境变量中。

    $ export PATH="$PWD/flutter/bin:$PATH"

  8. 开始使用 Flutter 进行开发。

    完成上述步骤后， Flutter 将在当前终端窗口中，从 flutter-io.cn 获取 package 和构建产物。

    要在所有终端上永久设置这些值，请按照说明将 Flutter 添加到 PATH 环境变量，同时还需要添加 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 环境变量。

下载基于镜像站点的 Flutter SDK 压缩包

#

需要从镜像中的 SDK 版本列表 下载 Flutter, 请将 storage.googleapis.com 替换为你信任的镜像站点 URL。在浏览器或其他应用程序中使用镜像站点（如 IDM 或 Thunder）将提高下载速度。

下面的示例展示了如何将下载 Flutter 的 URL，从 Google 更改为 CFUG 的镜像。

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

要下载 macOS arm64 版本的 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

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

配置你的机器发布 package

#

你需要能够访问 Google Auth 和 pub.dev 网站，才能将 package 发布到 pub.dev。

启用对 pub.dev 的访问：

  1. 配置代理。要配置代理，请查阅 Dart 关于代理的文档。

  2. 确认 PUB_HOSTED_URL 环境变量未设置或为空。

    $ echo $env:PUB_HOSTED_URL

    如果该指令返回任何值，则移除设置。

    $ Remove-Item $env:PUB_HOSTED_URL

  1. 配置代理。要配置代理，请查阅 Dart 关于代理的文档。

  2. 确认 PUB_HOSTED_URL 环境变量未设置或为空。

    $ echo $PUB_HOSTED_URL

    如果该指令返回任何值，则移除设置。

    $ unset $PUB_HOSTED_URL

  1. 配置代理。要配置代理，请查阅 Dart 关于代理的文档。

  2. 确认 PUB_HOSTED_URL 环境变量未设置或为空。

    $ echo $PUB_HOSTED_URL

    如果该指令返回任何值，则移除设置。

    $ unset $PUB_HOSTED_URL

了解关于发布 package 的更多信息，请查阅 关于发布 package 的 Dart 文档。

已知可信的社区镜像站点

#

Flutter 团队无法保证任何镜像的长期可用性。如果其他镜像可用，你可以使用它们。

Flutter 社区 (CFUG)

#

Flutter 社区 (CFUG) 维护着 flutter-io.cn 镜像。它包括 Flutter SDK 和 pub package。

配置你的机器使用镜像

#

请使用以下指令，设置你的机器使用该镜像。

在 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 用户组

#

上海交通大学 *nix 用户组 维护着 mirror.sjtu.edu.cn 镜像。它包括 Flutter SDK 和 pub package。

配置你的机器使用镜像

#

请使用以下指令，设置你的机器使用该镜像。

在 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 协会

#

清华大学 TUNA 协会 维护着 mirrors.tuna.tsinghua.edu.cn 镜像。它包括 Flutter SDK 和 pub package。

配置你的机器使用镜像

#

请使用以下指令，设置你的机器使用该镜像。

在 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 镜像目前均不支持/也不应支持上传 packages 到 pub.dev 网站。这个过程通常需要登录谷歌账号，而这将是一个无法绕开且复杂的挑战。
  • 上海大学的镜像 暂时只允许校内访问，故暂未展示，感谢上海大学 Linux 用户组的同学。
  • 腾讯云开源镜像站使用 TUNA 开源脚本制作，每天同步一次，经测试，其数据延迟较大并尚未配置有效的回源策略，有待于社区成员进一步验证。
  • 任何其他与镜像相关的问题，请通过 Issue 向我们反馈。
  • 部分镜像的问题已经特别标识，待镜像修复之后移除。

致谢

#

本页面列出的镜像由提供者分别维护，我们确保上述列出的镜像提供方不会对数据进行恶意修改，因为国内网络情况的复杂性和特殊性，我们无法保证镜像长期稳定性和访问速度，请谅解。

如果在镜像使用中有任何问题，欢迎通过邮件与我们联系：cfug-dev@googlegroups.com。非常感谢所有帮助 Flutter 在国内维护社区基础设施建设资源的社区和公司，查看 详细致谢名单。

除非另有说明，本文档之所提及适用于 Flutter 3.38.1 版本。本页面最后更新时间：2025-10-30。查看文档源码 或者 为本页面内容提出建议。