lara vel命令找不到是因为Composer全局bin目录未加入PATH环境变量。默认路径为~/.composer/vendor/bin（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Composer\vendor\bin（Windows），需手动添加至PATH并重新加载配置，再验证which lara vel或where lara vel是否生效。
先说一个核心判断：全局安装失败，95% 的情况并非 Composer 本身出了问题，而是 composer 命令压根没被系统 PATH 识别，或者全局 bin 目录的权限、归属设置不当。
为什么 composer global require lara vel/installer 执行后 lara vel 命令找不到？
问题根源其实很明确。Composer 全局安装的可执行文件（比如 lara vel），默认会存放在一个特定目录：
– macOS/Linux 系统：~/.composer/vendor/bin
– Windows 系统：%USERPROFILE%\AppData\Roaming\Composer\vendor\bin
关键在于，这个路径并不会自动加入系统的 $PATH 或 %PATH% 环境变量。所以，终端在茫茫路径中搜索时，自然就找不到这个命令。
- 首先，运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认上述路径是否已经出现在列表里。 - 临时验证安装是否成功：直接运行
~/.composer/vendor/bin/lara vel --version，如果能输出版本信息，那就说明安装是成功的，问题纯粹出在 PATH 配置上。 - Windows 用户请注意：
%USERPROFILE%\AppData\Roaming\Composer\vendor\bin中的AppData是一个隐藏目录，需要在文件资源管理器的地址栏手动输入路径才能看到。 - 顺便提个醒：别用
composer global install—— 这个命令根本不存在，正确的全局安装命令是composer global require。
Permission denied 写入 ~/.composer/vendor/bin 怎么办？
这个错误在 Linux/macOS 上比较常见，现象通常是执行 composer global require 时报出 failed to open stream: Permission denied。根本原因通常不是磁盘空间不足，而是目标目录或其父目录的所有权属于 root，或者权限被锁死了。
- 先检查目录归属：运行
ls -ld ~/.composer ~/.composer/vendor ~/.composer/vendor/bin，如果其中任何一个目录的所有者不是当前用户，那就出问题了。 - 修复命令：
sudo chown -R $USER:$USER ~/.composer（使用 sudo 需谨慎，仅在确认归属异常时使用）。 - 避免后续再出问题：永远不要使用
sudo composer global require—— 这会导致生成的二进制文件属于 root 用户，后续你既无法覆盖，也可能无法正常执行。 - 如果不慎已经误用了 sudo，除了修改目录归属，还需要删除
~/.composer/vendor/bin/lara vel等残留文件，然后重新安装。
全局安装后 composer diagnose 报 “The COMPOSER_HOME directory is not writeable”
这个报错意味着 Composer 自身的配置和缓存目录（默认是 ~/.composer）不可写，这会导致 global require、config --global 等所有全局操作全部失败。
- 运行
composer config --global home查看当前COMPOSER_HOME路径指向哪里。 - 检查该路径是否存在、是否可写：
ls -ld $(composer config --global home)。 - 如果路径指向一个深层嵌套的目录（例如 macOS 上的
/Users/xxx/Library/Application Support/Composer），很容易触发系统的权限限制。建议强制将其迁移到短路径：mkdir -p ~/comphome && composer config --global home ~/comphome。 - Windows 用户如果路径包含中文或空格（例如
C:\Users\张三\AppData\...），也可能导致部分工具解析失败，应尽量改用纯英文路径。
明明 PATH 加了，新终端还是认不出 lara vel？
PATH 修改后必须重新打开终端才能生效，并且要确认 shell 配置文件（如 ~/.zshrc、~/.bash_profile 或 Windows 的环境变量设置界面）确实已经保存并成功加载了。
- macOS/Linux：检查
~/.zshrc等配置文件是否有类似export PATH="$HOME/.composer/vendor/bin:$PATH"的语句，然后运行source ~/.zshrc使其立即生效。 - Windows：修改完环境变量后，必须关闭并重新打开 CMD、PowerShell 或终端应用，旧的窗口不会刷新 PATH 值。
- 验证是否真正生效：运行
which lara vel（macOS/Linux）或where lara vel（Windows），有输出才代表系统识别成功。 - IDE（如 PHPStorm、VS Code 的内置终端）可能会缓存旧的 PATH 值，需要重启 IDE 或在设置中指定正确的 shell 路径。
最后，还有一个最容易被忽略的细节：全局命令所依赖的 PHP 环境，和你项目里运行 composer install 的 PHP 环境，可能不是同一个。用 which php 查看的 PHP 路径，和 lara vel --version 命令内部使用的 PHP 版本对比一下，如果不一致，就会出现“扩展找不到”这类令人困惑的报错——这时候调整 PATH 是没用的，关键在于统一命令行（CLI）的 PHP 路径。这才是关键所在。
