flutter国内源如何配置

在Flutter开发中，国内访问官方源经常遇到网络问题，导致依赖下载失败。请问如何正确配置Flutter的国内镜像源？需要修改哪些配置文件？能否提供具体的步骤和常用的国内镜像地址？配置后如何验证是否生效？

2 回复

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

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

同时配置Flutter环境变量：

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 国内镜像配置可大幅提升依赖下载速度，主要通过环境变量设置实现。以下是具体方法：

1. 配置环境变量（推荐） 在系统环境变量中添加：

# 包托管镜像
PUB_HOSTED_URL=https://pub.flutter-io.cn
FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

# 如需使用清华镜像（备选）
# PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub
# FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter

2. 平台配置方法

  • Windows：
    系统属性 → 环境变量 → 新建用户变量
  • 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 ~/.zshrc 使配置生效

3. 项目级配置（可选） 在 Flutter 项目根目录的 android/build.gradle 中修改仓库：

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

验证方法：

flutter doctor

观察包下载是否使用镜像域名

注意事项：

  1. 镜像服务可能偶有不稳定，可临时切换回官方源
  2. 使用 Android Studio 时建议同时配置 Gradle 镜像
  3. 首次运行 flutter pub get 时观察下载速度确认配置生效

常用镜像源：

回到顶部