flutter如何配置镜像站点

在Flutter开发中，由于网络原因经常无法正常下载依赖包。请问如何配置Flutter的镜像站点来加速资源下载？具体需要修改哪些配置文件？有没有推荐的国内镜像地址？配置完成后如何验证是否生效？求详细的操作步骤说明。

2 回复

在Flutter项目中，配置镜像站点需修改环境变量。Windows在系统环境变量中添加PUB_HOSTED_URL和FLUTTER_STORAGE_BASE_URL；macOS/Linux在终端执行export命令。例如使用清华镜像：

export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub
export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter

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


在 Flutter 开发中，配置镜像站点可以加速依赖包的下载，特别是在中国大陆地区。以下是配置方法：

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

设置以下环境变量，适用于 Windows、macOS 和 Linux：

Windows（PowerShell）：

$env:PUB_HOSTED_URL="https://pub.flutter-io.cn"
$env: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

永久生效可添加到 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）中。

2. Flutter 项目配置

在项目根目录的 pubspec.yaml 中添加：

environment:
  sdk: ">=2.12.0 <3.0.0"

# 添加镜像配置
publish_to: 'none'
flutter:
  sources:
    - https://pub.flutter-io.cn

3. 常用镜像地址

  • 官方社区镜像：
    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

4. 验证配置

运行 flutter doctor，观察包下载速度是否提升。

注意事项

  • 镜像地址可能更新，建议查看对应镜像站点的最新文档
  • 企业内网可自建镜像服务器
  • 配置后如遇问题，可临时取消环境变量进行排查

通过以上配置，可显著提升 Flutter 相关资源的下载速度。

回到顶部