PATH未配置导致command not found，Composer全局命令软链接在vendor/bin目录但系统未识别，需手动添加该路径到环境变量并重启终端验证。
“composer global require 装了却 command not found”不是安装失败，是 PATH 没配对——90% 的问题根源在这里，不是命令写错、不是网络慢、也不是 Composer 版本低。
为什么 laravel 或 php-cs-fixer 命令始终报 command not found
Composer 把这些可执行文件软链接到了全局 vendor/bin 目录（Linux/macOS 是 $HOME/.composer/vendor/bin，Windows 是 %APPDATA%\Composer\vendor\bin），但这个路径默认不在系统 PATH 里。Shell 根本找不到它，自然报错。
- 验证是否生效：运行
which laravel（macOS/Linux）或where laravel（Windows），没输出就说明路径没加对 - 别靠记忆拼路径：用
composer global config bin-dir --absolute直接获取真实路径，它会输出类似/home/alex/.composer/vendor/bin的结果 - Windows 用户注意：
%APPDATA%在「环境变量」界面里不会自动展开，必须填完整路径，例如C:\Users\Alice\AppData\Roaming\Composer\vendor\bin - macOS 用户若用 zsh（默认），改的是
~/.zshrc；bash 用户改~/.bash_profile；改完必须运行source ~/.zshrc或新开终端
composer global require 到底做了什么，哪些参数无效
它只做两件事：把包下载进全局 vendor 目录，并把 composer.json 中 bin 字段声明的脚本软链接到 vendor/bin。不改 PATH，命令就永远调不了。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--dev参数会被完全忽略：全局安装没有require-dev概念，composer global require --dev phpunit/phpunit和不加一样 - 别用
sudo composer global require：会导致~/.composer归属 root，后续所有操作权限失败；修复只需chown -R $USER ~/.composer - 它不处理 PHP 版本兼容性或 autoload 冲突，只是“放好链接”——如果包本身依赖 PHP 8.2，而你本地是 PHP 7.4，装得进去，但运行时直接报错
- 想查装了啥：用
composer global list；想看某个包提供了哪些命令：用composer global show laravel/installer --all | grep bin
如何安全升级或卸载全局工具
composer global update 看起来省事，实际风险很高：它会强行拉取所有全局包的最新兼容版本，但不同工具对 symfony/console、php 版本等依赖可能互相冲突，报错时连哪个包导致的都看不到。
- 推荐先运行
composer global outdated，它只列出可升级项，不改任何东西 - 再针对性升级：比如
composer global require laravel/installer:^5.0，显式指定版本约束更可控 - 卸载需要 Composer ≥ 2.5：
composer global remove laravel/installer；旧版本只能手动删~/.composer/vendor/laravel/installer并清理vendor/bin/laravel链接 - 临时验证命令是否可用，可用
composer global exec laravel --version（Composer ≥ 5.4），但它不解决 TTY 交互问题（如psysh会卡住），也不替代 PATH 配置
全局配置 github-oauth、镜像源等为什么设了没用
不是命令输错了，而是这些配置项有严格的作用域规则：有些必须带 --global 才生效，有些只在当前目录无 composer.json 时兜底，还有些根本不在全局支持范围内。
- 必须用
--global的典型项：github-oauth.github.com、http-basic.repo.example.com、repo.packagist（国内镜像）——漏掉就只改当前项目 - 看似全局、实则被项目覆盖的：
minimum-stability、prefer-stable：一旦项目有composer.json，它们立刻失效 - 完全无效的：
autoload、require、scripts：设了也静默丢弃，Composer 不读这些字段的全局值 - 改完镜像源后，务必运行
composer clear-cache，否则旧源还在内存里继续试，卡在Resolving dependencies
真正容易被忽略的点是：PATH 配错一次，后续所有全局命令都失效；而 composer global require 成功输出不代表命令可用，它只管“装包”，不管“让 shell 找得到”。每次加完路径，必须新开终端验证，不能只信 echo $PATH 里有就以为万事大吉。
