执行flutterfire命令提示zsh:command not found的排查求助

排查方向及解决步骤 #

1. 环境变量未即时生效 #

修改~/.zshrc后，zsh不会自动加载新配置，必须手动执行：

source ~/.zshrc

执行完再试flutterfire configure命令。

2. 验证flutterfire是否真的安装成功 #

先检查~/.pub-cache/bin目录里有没有flutterfire可执行文件：

ls ~/.pub-cache/bin

如果找不到，说明dart pub global activate flutterfire_cli执行失败，重新跑一遍这个命令，仔细看输出有没有错误提示（比如网络问题、依赖缺失）。

3. 确认dart的环境变量配置 #

如果dart的bin目录没加入PATH，pub global activate可能没法正常安装工具。检查dart路径是否在PATH里：

echo $PATH | grep dart

要是没找到，把dart的bin目录（通常是$HOME/flutter/bin/cache/dart-sdk/bin）添加到~/.zshrc：

export PATH="$PATH":"$HOME/flutter/bin/cache/dart-sdk/bin"

执行source ~/.zshrc生效后，重新激活flutterfire_cli。

4. 权限问题导致安装不完整 #

安装firebase-tools时可能因为权限不够没装全，试试加sudo重装：

sudo npm install -g firebase-tools

另外检查~/.pub-cache目录的权限，确保所有者是当前用户：

ls -ld ~/.pub-cache

如果不是，修改权限：

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

之后重新运行dart pub global activate flutterfire_cli。

5. 确认flutterfire_cli的安装状态 #

用下面的命令查看已安装的全局dart包：

dart pub global list

如果输出里没有flutterfire_cli，说明确实没装成功，重新执行激活命令，排查报错原因。

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