Ubuntu 21.10下激活flutterfire_cli失败如何解决

• 主机系统：Ubuntu 21.10（Linux）
• Flutter为手动安装部署，各组件版本：
  • Flutter 3.0.3（stable稳定通道）
  • Dart SDK 2.17.5
  • firebase 11.1.0
• 故障表现：执行dart pub global activate flutterfire_cli命令激活flutterfire_cli时抛出错误，flutter doctor命令运行无异常报错。

按以下顺序操作，每步完成后可重试激活命令验证是否修复：

1. 修复Pub缓存目录权限
   手动部署Flutter的Ubuntu环境下，这类激活报错90%以上是当前用户对Dart全局包缓存目录无读写权限导致，直接执行命令修复即可：

   sudo chown -R $USER:$USER ~/.pub-cache
   

   注意：全程不要用sudo执行dart pub global activate相关命令，否则会把全局包目录权限切到root用户，后续普通用户调用会持续报权限错误。
2. 校验环境变量配置
   打开当前所用shell的配置文件（使用Bash则编辑~/.bashrc，使用Zsh则编辑~/.zshrc），确认已添加Pub全局可执行文件路径配置：

   export PATH="$PATH":"$HOME/.pub-cache/bin"
   

   添加完成后执行source ~/.bashrc（对应自己的shell配置文件路径）让配置即时生效。
3. 指定兼容版本安装
   你当前使用的Dart 2.17.5版本不支持最新版flutterfire_cli（最新版已要求Dart 3.0及以上SDK），直接指定适配Dart 2.17分支的稳定版本安装即可避开版本不兼容报错：

   dart pub global activate flutterfire_cli 0.2.7
   

4. 修复损坏的Pub缓存
   如果以上操作后仍报错，执行命令清理修复损坏的缓存文件后重试安装：

   dart pub cache repair
   dart pub global activate flutterfire_cli 0.2.7
   

内容的提问来源于stack exchange，提问作者Nayla