composer环境变量配置错误根源在于path、composer_home、php_binary、composer_cache_dir至少一个错位或冲突；需依报错关键词精准排查，而非重装。windows查where composer是否返回路径，linux/macos确认$(composer config --global bin-dir)已加进shell配置；composer_home须为绝对路径且与运行用户$home一致；镜像url必须https且结尾带/；变量间存在严格优先级，覆盖关系决定实际生效值。
Composer环境变量配置错误不是“装没装好”的问题，而是PATH、COMPOSER_HOME、PHP_BINARY、COMPOSER_CACHE_DIR这四个变量中至少一个指向错位或冲突了——直接看报错关键词，比重装快十倍。
composer命令找不到？先查PATH里有没有composer.bat或vendor/bin
Windows下报“不是内部或外部命令”，Linux/macOS下报“command not found”，本质是系统压根没找到可执行入口。
- Windows：运行
where composer，应返回类似C:\ProgramData\ComposerSetup\bin\composer.bat；若为空，说明%PROGRAMDATA%\ComposerSetup\bin没进系统PATH（注意：只加到bin目录，不带文件名） - Linux/macOS：全局命令（如
laravel）实际在$(composer config --global bin-dir)，必须手动加进~/.bashrc或~/.zshrc：export PATH="$(composer config --global bin-dir):$PATH" - 改完PATH后必须新开终端，旧窗口不会自动加载新值；Windows用户还要确认
composer.bat真实存在该路径下
composer能运行但global命令用不了？检查COMPOSER_HOME和PATH是否匹配
现象是composer global require laravel/installer成功，但敲laravel -V仍报错。这不是Composer没装好，是它把二进制文件放到了A路径，而你让系统去B路径找。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config --global home，得到全局根目录（如C:\Users\Alice\AppData\Roaming\Composer） - 确认
vendor/bin子目录真实存在且含laravel.bat（Windows）或laravel（macOS/Linux） - 把该完整路径（例如
%APPDATA%\Composer\vendor\bin）加进系统PATH——别用~/.composer/vendor/bin这种带波浪线的写法，Windows不解析 - 特别注意：如果设过
COMPOSER_HOME环境变量，它必须是绝对路径，不能含%USERPROFILE%或$HOME，否则vendor/bin路径会拼错
composer install卡住或报SSL/Permission错误？优先验证COMPOSER_CACHE_DIR和属主
报“Permission denied”写缓存，或“Could not fetch”却无明确错误，大概率是缓存目录被root占了，或COMPOSER_CACHE_DIR覆盖了配置导致路径错乱。
- 运行
echo $COMPOSER_CACHE_DIR（Linux/macOS）或echo %COMPOSER_CACHE_DIR%（Windows），非空就说明它正在生效，composer config --global cache-dir写的值已被忽略 - 查缓存目录属主：
ls -ld $(composer config --global cache-dir)，第三列不是当前用户就立刻修复：sudo chown -R $USER:$USER $(composer config --global cache-dir) - CI/CD中避免用
/tmp/composer-cache，推荐按PHP版本隔离：composer config --global cache-dir "$HOME/.composer-cache-$PHP_VERSION" - 如果
composer diag显示Cache is not working due to permissions，说明路径存在但不可写，Composer已悄悄退回到默认位置，此时composer config cache-dir输出的路径不可信
composer config -g写入后不生效？看是不是被项目级配置或环境变量屏蔽了
执行composer config -g repo.packagist输出为空，或composer install -vvv日志里仍出现packagist.org，说明全局配置根本没被读到。
- 先确认
COMPOSER_HOME是否被覆盖：运行composer config --global home，输出路径必须和当前运行Composer的用户实际$HOME/.composer一致；若不一致（比如CI里用root配的，但PHP进程以www-data跑），配置就写进了别人家目录 - 项目级
composer.json里只要存在"repositories"字段（哪怕值是[]或{"packagist.org": false}），就会彻底屏蔽全局镜像源——运行composer config repositories即可验证 - 镜像URL末尾必须带
/，且协议必须是HTTPS：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致404后静默回退）
真正容易被忽略的是：所有这些变量之间有明确的优先级——COMPOSER_CACHE_DIR > composer config cache-dir，PHP_BINARY > PATH里的php.exe，项目级repositories > 全局repo.packagist。不看优先级直接改配置，等于在迷宫里乱撞。
