composer全局命令不可用的根本原因是未将$composer_home/vendor/bin（linux/macos）或%composer_home%\vendor\bin（windows）加入path，且composer_home必须为绝对路径、不含环境变量，设后需重启终端并验证；全局配置项中github-oauth等稳定生效，minimum-stability等仅空目录下生效，autoload等完全无效。
Composer 没有“全局变量”这个东西，所谓“设置全局变量”，实际是两件独立的事：一是用 composer config -g 写入跨项目的配置项（如镜像源、token），二是正确设置 COMPOSER_HOME 环境变量并将其 vendor/bin 目录加入系统 PATH，否则 laravel、phpunit 这类全局命令永远报 command not found。
为什么 composer global require 装了却找不到命令？
根本不是安装失败，而是 shell 根本没去 $COMPOSER_HOME/vendor/bin 里找可执行文件。Composer 只负责把脚本放进去，从不碰 PATH。
- Linux/macOS：必须在
~/.zshrc或~/.bashrc里加export PATH="$COMPOSER_HOME/vendor/bin:$PATH"，然后source并新开终端 - Windows：把
%COMPOSER_HOME%\vendor\bin（不是%APPDATA%\Composer\vendor\bin）加进「用户环境变量 → Path」，加完必须新开 CMD/PowerShell - 验证方式：
which laravel（macOS/Linux）或where laravel（Windows），输出路径必须含vendor/bin - 常见静默错误：PATH 中用了
~或$HOME—— shell 展开后才有效，但 Composer 不识别；或漏写了\vendor\bin后缀
composer config -g 哪些配置项真能跨项目生效？
不是所有键都支持全局作用域。Composer 对不同字段的读取逻辑完全不同，设错等于白设。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 稳定全局生效（项目级无法覆盖）：
github-oauth、http-proxy、cache-dir、process-timeout、secure-http - 受限生效（仅在空目录下运行
composer require时才读）：minimum-stability、prefer-stable、platform - 完全无效（设了也丢弃）：
autoload、require、scripts - 验证是否写对：
composer config -g --list看是否出现目标键；再运行composer config --list，带(global)标记的才是当前生效值
COMPOSER_HOME 必须为绝对路径，且与 PATH 中的 bin 路径严格匹配
它不是配置项，而是 Composer 查找全局文件的“根目录开关”。设错会导致 config.json 找不到、缓存失效、vendor/bin 命令不可用，三者全崩。
- Linux/macOS 示例：
export COMPOSER_HOME="/opt/composer"，PATH 就得对应写$COMPOSER_HOME/vendor/bin - Windows 示例：
set COMPOSER_HOME=C:\tools\composer，PATH 就得加%COMPOSER_HOME%\vendor\bin - 不能用
~、$HOME、%USERPROFILE%—— 这些在环境变量层面不展开，Composer 会直接拼出非法路径 - 设完必须新开终端，再用
composer config -g --list确认 “Global configuration file” 路径是否匹配
最容易被忽略的是：全局配置和全局命令是两套机制，混在一起排查只会延长故障时间。先确认 which composer 和 which laravel 都能返回路径，再查 config -g 是否生效，顺序错了，90% 的问题会卡在第一步。
