Flutter国内镜像pub.flutter-io.cn的使用方法

在Flutter开发中，使用pub.flutter-io.cn镜像时遇到配置问题。按照官方文档修改环境变量FLUTTER_STORAGE_BASE_URL和PUB_HOSTED_URL后，执行flutter pub get仍然无法正常下载依赖包。终端提示连接超时或找不到资源，但直接访问镜像网址是正常的。请问正确的配置步骤是什么？是否需要额外设置代理或清除缓存？

2 回复

在Flutter项目的PUB_HOSTED_URL环境变量中设置：

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

或修改项目中的pubspec.yaml文件，添加：

publish_to: 'https://pub.flutter-io.cn'

然后运行flutter pub get即可使用国内镜像加速依赖下载。

更多关于Flutter国内镜像pub.flutter-io.cn的使用方法的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在Flutter项目中使用国内镜像 pub.flutter-io.cn 可以显著提升依赖包的下载速度。以下是具体配置方法：

方法一：临时环境变量（推荐用于单次使用） 在命令行执行以下命令后运行 flutter pub get：

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

方法二：永久环境变量配置

  1. Windows：

    • 系统属性 → 环境变量 → 新建系统变量：
      • 变量名：PUB_HOSTED_URL，变量值：https://pub.flutter-io.cn
      • 变量名：FLUTTER_STORAGE_BASE_URL，变量值：https://storage.flutter-io.cn

  2. macOS/Linux： 在 ~/.bash_profile 或 ~/.zshrc 中添加：

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

    执行 source ~/.bash_profile 使配置生效。

方法三：项目级配置 在项目根目录的 pubspec.yaml 同级创建 tool 文件夹，新建 config.yaml 文件：

pub-repositories:
  flutter-io:
    url: https://pub.flutter-io.cn

验证方法 执行 flutter pub get 时观察下载地址是否变为镜像域名。

注意事项

  • 镜像服务可能出现不稳定，若遇到问题可临时取消环境变量恢复官方源
  • 执行 flutter packages pub run 时也需配置相同环境变量

推荐使用方法二进行永久配置，一劳永逸解决下载速度问题。

回到顶部