flutter国内镜像如何配置

在Flutter开发中，由于网络问题经常遇到依赖下载失败的情况。想请教大家如何配置Flutter的国内镜像？具体需要修改哪些配置文件？镜像地址推荐使用哪个比较稳定？配置完成后还需要执行什么命令来验证是否生效？如果在Android Studio中开发，是否需要额外设置？

2 回复

Flutter国内镜像配置方法：

  1. 环境变量配置（推荐） Windows系统：
setx PUB_HOSTED_URL "https://pub.flutter-io.cn"
setx FLUTTER_STORAGE_BASE_URL "https://storage.flutter-io.cn"

Mac/Linux系统：

export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
  1. 永久配置 在用户目录下的.bash_profile或.zshrc文件中添加：
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
  1. Android Studio配置 在Flutter插件设置中，添加镜像地址：
https://pub.flutter-io.cn

配置完成后重启终端，使用flutter doctor验证。如果下载速度变快，说明配置成功。

更多关于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
  3. 同样方法新建：
    • 变量名：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

永久生效可添加到 ~/.bash_profile 或 ~/.zshrc：

echo 'export PUB_HOSTED_URL=https://pub.flutter-io.cn' >> ~/.zshrc
echo 'export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn' >> ~/.zshrc
source ~/.zshrc

2. Flutter 项目配置

在项目根目录的 android/build.gradle 文件中修改仓库地址：

buildscript {
    repositories {
        // 添加阿里云镜像
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
    }
}

3. 验证配置

运行以下命令检查是否生效：

flutter doctor

观察包下载是否使用镜像地址。

注意事项

  • 镜像服务可能偶尔不稳定，若遇到问题可暂时恢复官方源
  • 企业内网环境可能需要额外代理配置

完成配置后，Flutter SDK 和 Pub 包将优先从国内镜像站下载，提升开发效率。

回到顶部