flutter如何配置国内镜像

在Flutter开发中，由于网络原因经常遇到依赖下载慢或失败的情况。请问应该如何正确配置国内镜像来加速Flutter的依赖下载？具体需要修改哪些配置文件，是否需要同时设置PUB_HOSTED_URL和FLUTTER_STORAGE_BASE_URL这两个环境变量？不同操作系统（Windows/macOS/Linux）的配置方式有什么区别吗？求详细的配置步骤和注意事项。

2 回复

在Flutter项目根目录的android/build.gradle文件中，将google()和jcenter()替换为阿里云镜像：

maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/public' }

同时设置环境变量：

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

更多关于flutter如何配置国内镜像的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在Flutter中配置国内镜像可以显著提升依赖包下载速度，以下是具体配置方法：

方法一：环境变量配置（推荐） 在系统环境变量中添加以下两个变量：

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

Windows系统配置步骤：

  1. 右键“此电脑” → 属性 → 高级系统设置
  2. 点击“环境变量”
  3. 在“系统变量”中新建：
    • 变量名：PUB_HOSTED_URL
    • 变量值：https://pub.flutter-io.cn
  4. 再新建：
    • 变量名：FLUTTER_STORAGE_BASE_URL
    • 变量值：https://storage.flutter-io.cn

macOS/Linux配置步骤： 在终端执行：

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

或将这两行添加到 ~/.bashrc 或 ~/.zshrc 文件末尾，然后执行 source ~/.bashrc

方法二：Flutter项目配置 在项目根目录的 android/build.gradle 文件中添加：

buildscript {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
    }
}

验证配置： 运行 flutter doctor，观察包下载速度是否改善。

其他可用镜像地址：

  • 腾讯云镜像：https://mirrors.cloud.tencent.com/flutter
  • 上海交大镜像：https://mirrors.sjtug.sjtu.edu.cn

配置完成后，重启终端或IDE即可生效。

回到顶部