flutter国内镜像如何配置

在Flutter开发中，由于网络限制，国内访问官方源速度很慢。请问如何配置Flutter的国内镜像源？具体需要修改哪些文件或环境变量？有没有推荐的稳定镜像地址？配置完成后如何验证是否生效？

2 回复

在Flutter项目中配置国内镜像，可以通过设置环境变量解决。推荐两种方式：

  1. 临时配置（命令行） Windows：
set PUB_HOSTED_URL=https://pub.flutter-io.cn
set 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. 永久配置
  • Windows：在系统环境变量中添加上述两个变量
  • Mac/Linux：将export语句添加到~/.bash_profile或~/.zshrc

验证配置：

flutter doctor

看到正常输出即配置成功。

注意：镜像源使用上海交大和Flutter官方中国镜像，能显著提升包下载速度。如果使用Android Studio，建议在IDE中也配置相同环境变量。

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


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

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

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

Windows系统配置步骤：

  1. 右键“此电脑” → 属性 → 高级系统设置
  2. 点击“环境变量”
  3. 在“系统变量”中新建上述两个变量

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

方法二：使用Flutter命令行配置

flutter config --no-analytics
flutter config --android-sdk <你的Android SDK路径>

验证配置是否生效： 运行 flutter doctor，观察依赖下载是否使用镜像地址。

注意事项：

  • 镜像地址可能会变更，建议关注官方文档
  • 如使用企业网络，可能需要额外配置代理
  • 镜像服务由社区维护，如遇问题可暂时切回官方源

配置完成后，Flutter SDK和Pub包管理器将自动使用国内镜像，大幅提升下载速度。

回到顶部