flutter如何配置国内镜像源

在Flutter开发中，由于网络限制，经常遇到依赖下载缓慢或失败的问题。请问如何正确配置Flutter的国内镜像源来加速依赖下载？具体需要修改哪些配置文件，是否需要同时配置PUB_HOSTED_URL和FLUTTER_STORAGE_BASE_URL这两个环境变量？不同操作系统（Windows/macOS/Linux）的配置方式是否有区别？能否提供一个完整的配置示例？

2 回复

在Flutter项目根目录的android文件夹中，找到build.gradle文件，将repositories和dependencyResolutionManagement中的URL替换为阿里云镜像源：

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

保存后重新同步即可。

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


在 Flutter 中配置国内镜像源可以显著提升依赖包下载速度，避免网络问题。以下是配置方法：

1. 配置环境变量（推荐）

在系统环境变量中添加以下两个变量：

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

Windows 系统：

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

macOS/Linux 系统：

编辑 shell 配置文件（如 ~/.bashrc、~/.zshrc）：

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

执行 source ~/.bashrc（或对应配置文件）使配置生效。

2. 使用 Flutter 命令配置（临时）

运行以下命令临时设置：

flutter pub config set hosted_url https://pub.flutter-io.cn

3. 检查配置是否生效

运行 flutter doctor，观察依赖下载是否使用镜像源。

注意事项：

  • 镜像源由社区维护，若遇到问题可切换回官方源（删除环境变量即可）。
  • 执行 flutter pub get 或创建新项目时，镜像源会自动生效。

完成配置后，Flutter SDK 和依赖包会通过国内镜像加速下载。

回到顶部