根本原因是PATH未配置，而非安装失败；composer global require仅将包放入全局vendor目录并链接bin脚本，必须手动将~/.composer/vendor/bin（Linux/macOS）或%APPDATA%\Composer\vendor\bin（Windows）加入系统PATH并重载配置才能调用。
装完 composer global require 的包，命令还是报 command not found？不是安装失败，是 PATH 没配对 —— 这是 90% 的真实原因。
为什么 composer global require 装完命令却用不了
它只做两件事：把包放进 ~/.composer/vendor（Linux/macOS）或 %APPDATA%\Composer\vendor（Windows），再把 composer.json 里 bin 字段声明的脚本软链接到对应 vendor/bin/ 目录。Shell 根本不认这个路径，除非你手动加进 PATH。
- 常见错误现象：
which laravel或where laravel无输出；echo $PATH里没出现~/.composer/vendor/bin（macOS/Linux）或%APPDATA%\Composer\vendor\bin（Windows） - 别猜路径：运行
composer global config bin-dir --absolute直接拿到真实bin路径 - 软链接 ≠ 复制：删掉
~/.composer/vendor，所有命令立刻失效
怎么正确配置 PATH 让全局命令生效
路径必须完整、准确，并且 shell 要重载配置。写错一个字符或漏掉重载，就白配。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- macOS/Linux：
zsh用户改~/.zshrc，bash用户改~/.bash_profile，末尾加：export PATH="$HOME/.composer/vendor/bin:$PATH"（若设过COMPOSER_HOME，则用$COMPOSER_HOME/vendor/bin） - Windows：在「环境变量」→「用户变量」→「Path」中新增完整路径，例如
C:\Users\Alice\AppData\Roaming\Composer\vendor\bin—— 注意不能写%APPDATA%，系统不展开 - 改完必须新开终端，或运行
source ~/.zshrc（macOS/Linux）；旧窗口不会自动更新PATH
composer global 哪些子命令能用、哪些是坑
composer global 本身不是命令，单独敲会报错或只显示帮助。所有操作都得带子命令。
- 有效子命令：
require（安装）、update（更新全部）、remove（卸载，需 Composer ≥ 2.5）、exec（临时调用，如composer global exec laravel new blog，需 Composer ≥ 5.4） -
--dev参数会被忽略：全局没有require-dev概念，加了也白加 - 别用
sudo composer global require：会导致~/.composer归属变成root，后续所有全局操作权限失败；修复用chown -R $USER ~/.composer
验证是否真通了，别靠感觉
别只看 composer global require 输出 Using version ^4.4 for laravel/installer 就以为成了 —— 那只是包进 vendor，不代表命令可用。
- 运行
which laravel（macOS/Linux）或where laravel（Windows），有路径输出才算成功 - 直接输
laravel --version，有版本号返回才确认走通 - 想查某个工具是否真被链接进来：
ls -l ~/.composer/vendor/bin/ | grep laravel（macOS/Linux），能看到软链接指向
最常被忽略的点：PATH 配的是绝对路径，但很多人抄错斜杠、漏写 vendor/bin、或在 Windows 环境变量里用了未展开的 %APPDATA% —— 这些细节一错，前面所有步骤全白干。
