解决Dart Pub Add错误：配置国内镜像

引言

随着Flutter的快速发展和迭代，很多开发者在更新到最新版本后可能会遇到一些配置和环境问题。本文将通过一个实例，详细介绍如何解决在新版Flutter中使用dart pub add命令时遇到的网络连接问题。

问题描述

假设你刚刚升级到了Flutter 3.16，并创建了一个新的项目。尝试使用dart pub add <package_name>命令安装包时，出现了如下错误：

Got socket error trying to find package firebase_messaging_platform_interface at https://pub.dev. exit code 69

这个错误表明，Flutter的包管理器无法从官方源（pub.dev）获取包资源。

解决步骤

1. 确认问题来源

首先，我们要确认这是因为网络问题导致的。通过查看错误信息，我们可以看到是尝试访问pub.dev时发生了socket错误。

2. 配置国内镜像源

由于网络原因，很多开发者在中国大陆访问pub.dev可能会遇到问题。为了解决这个问题，我们需要配置Flutter的国内镜像源。

在Windows环境下：

• 右键点击此电脑或我的电脑，选择属性。
• 点击高级系统设置。
• 在系统属性窗口中，选择环境变量。
• 在系统变量部分，点击新建：
  • 变量名:PUB_HOSTED_URL
  • 变量值:https://pub.flutter-io.cn
  • 再添加一个变量：
    • 变量名:FLUTTER_STORAGE_BASE_URL
    • 变量值:https://storage.flutter-io.cn

在macOS或Linux环境下：

你可以通过修改.bash_profile或.zshrc文件来添加环境变量：

exportPUB_HOSTED_URL="https://pub.flutter-io.cn"exportFLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

然后运行source ~/.bash_profile或source ~/.zshrc使之生效。

3. 验证配置

配置完成后，重新打开一个新的命令行窗口（以确保环境变量生效），然后尝试再次运行dart pub add <package_name>。如果配置正确，你应该能成功安装包。

实例

假设你需要安装firebase_messaging包：

dart pubaddfirebase_messaging

如果一切配置正确，这个命令应该能够顺利执行，并且在pubspec.yaml文件中添加相关依赖。

结语

通过调整环境变量并配置国内镜像，可以有效解决在Flutter开发中因网络问题导致的包管理问题。希望本文能帮助到遇到类似问题的开发者，顺利进行Flutter项目开发。