配置路径后仍提示flutterfire命令未找到，未安装至.pub-cache/bin

一、清理异常缓存并强制重装 #

• 删除报错的characters-1.2.1缓存目录：

  rm -rf /Users/MYUSER/.pub-cache/hosted/pub.dartlang.org/characters-1.2.1
  

• 强制重新激活FlutterFire CLI：

  dart pub global activate --force flutterfire_cli
  

二、检查Pub缓存目录权限 #

MacOS下目录权限异常会导致安装文件无法写入：

• 查看.pub-cache权限：

  ls -ld ~/.pub-cache
  

• 如果权限不属于当前用户，修改为当前用户所有：

  sudo chown -R $(whoami) ~/.pub-cache
  

三、验证PATH配置生效 #

确保环境变量配置已加载：

• 刷新当前终端的环境变量：

  source ~/.zshrc
  

• 检查.pub-cache/bin是否在PATH中：

  echo $PATH | grep ".pub-cache/bin"
  

  若无输出，检查.zshrc是否存在拼写错误，同时确认当前终端使用的是zsh（执行echo $SHELL，输出应为/bin/zsh）。

四、使用Flutter自带Dart执行激活命令 #

尝试直接调用Flutter内置的dart命令完成激活：

flutter pub global activate flutterfire_cli

五、源码手动安装（备选方案） #

如果上述方法均无效，直接从源码安装：

git clone https://github.com/firebase/flutterfire.git
cd flutterfire/packages/flutterfire_cli
dart pub get
dart pub global activate --source path .

完成后执行flutterfire --version验证是否安装成功。

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