zsh报错command not found: laravel 命令找不到如何解决

按以下顺序逐次排查：

• 确认 composer 全局 bin 目录真实路径
  手动填写的 $HOME/.config/composer/vendor/bin 不一定匹配当前环境，不同操作系统、composer 版本的全局 vendor 路径存在区别，直接执行命令获取准确路径即可：

  composer global config bin-dir --absolute
  

  记录该命令输出的完整路径，后续所有配置统一使用这个真实路径，不要直接套用教程里的默认路径。
• 修正 PATH 配置，确保永久生效不被覆盖
  直接在终端执行 export 属于临时生效配置，关闭终端会话后就会失效，需要把配置写入 zsh 的永久配置文件：
  1. 打开 zsh 配置文件：

     nano ~/.zshrc
     

  2. 滚动到文件最末尾，添加 PATH 配置，将下方命令中的路径替换为上一步查到的 composer 全局 bin 真实路径：

     export PATH="替换为第一步查到的真实composer全局bin路径:$PATH"
     

     注意：这行配置必须放在 .zshrc 文件的最末尾，避免被 oh-my-zsh 插件、其他环境配置覆盖 PATH 值，导致配置不生效。

  3. 按 Ctrl+O 后敲回车保存文件，再按 Ctrl+X 退出编辑器，执行命令让配置立即在当前终端生效：

     source ~/.zshrc
     

• 校验 laravel 安装器是否安装成功
  执行命令查看全局 bin 目录下是否存在 laravel 可执行文件，将路径替换为第一步查到的真实路径：

  ls 替换为第一步查到的composer全局bin路径 | grep laravel
  

  如果命令没有任何输出，说明之前的全局安装流程失败，重新执行安装命令，开启详细输出模式查看具体报错：

  composer global require laravel/installer -v
  

  若安装过程中出现权限报错，给 composer 全局目录补全当前用户的读写权限即可，不要用 sudo 执行 composer 全局安装，否则会残留后续权限问题。
• 最终验证
  执行 echo $PATH，确认输出内容中包含你添加的 composer 全局 bin 路径；再执行 which laravel，如果能正常输出 laravel 可执行文件的完整路径，说明配置已经生效，此时执行 laravel --version 就可以正常输出版本号，不会再出现命令找不到的报错。

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