Composer环境变量冲突源于执行主体、PATH优先级与配置层级错位，需逐层校验COMPOSER_HOME路径、项目级repositories覆盖及镜像URL末尾斜杠，并清缓存生效。
Composer环境变量配置冲突不是安装问题，而是运行时用户身份、PATH优先级和配置层级三者错位的结果。直接改环境变量不解决问题，必须按执行主体逐层校验。
COMPOSER_HOME 路径错配导致全局配置写进“别人家”
执行 composer config -g repo.packagist 后输出为空，不是命令失败，而是配置被写进了另一个用户的 ~/.composer/config.json。常见于 CI/CD、Docker 或宝塔：你用 root 配的，但 PHP 进程以 www-data 或 git 用户运行，它只读自己家目录下的配置。
- 验证方式：
composer config --global home输出的路径，必须和当前运行 Composer 的用户实际可访问的$HOME/.composer一致 - Linux/macOS 下检查：
echo $COMPOSER_HOME，再确认该路径是否存在且可读写 - 宝塔面板中，PHP 执行脚本需在开头加：
export COMPOSER_HOME=/home/www/.composer - Docker 中避免用
sudo配置；应在构建阶段以目标用户身份执行composer config -g
项目级 repositories 字段静默屏蔽全局镜像
即使 composer config -g repo.packagist 输出正确 JSON，composer install -vvv 日志里仍出现 packagist.org 或 codeload.github.com——这是项目级 composer.json 中的 "repositories" 字段在作祟。Composer 的源优先级是：项目级 > 全局 > 默认源，没有协商，没有 fallback。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 快速检查：
composer config repositories，看输出是否含https://repo.packagist.org - 定位硬编码：
grep -A5 '"repositories"' composer.json - 临时禁用：
composer config --unset repositories（注意无-g） - 若必须保留项目级源，请确保其值为完整对象，且包含
"packagist.org": false显式关闭默认源
镜像 URL 缺少末尾斜杠引发 404 并静默回退
配置命令里漏掉 URL 末尾的 /，比如写成 https://mirrors.aliyun.com/composer，Composer 会拼出错误路径 /composerpackages.json，返回 404，然后安静切回官方源——不报错、不提示、日志里也只显示 “Could not fetch”。
- 真实生效的 URL 必须带 trailing slash，且协议为 HTTPS：
✅ 正确：https://mirrors.aliyun.com/composer/
❌ 错误：https://mirrors.aliyun.com/composer（少/）
❌ 错误：http://mirrors.aliyun.com/composer/（非 HTTPS） - 直接验证：
curl -I https://mirrors.aliyun.com/composer/，应返回200 OK或301 Moved Permanently - 换镜像后仍走官方源？别只查全局配置，用
echo $COMPOSER_REPO_PACKAGIST看环境变量是否覆盖了所有层级
Windows 下 PATH 顺序导致 PHP 版本错乱和 composer.bat 找不到
PHP 8.3 安装后 php -v 显示旧版本，或 composer --version 报“不是内部或外部命令”，本质是 Windows PATH 查找逻辑和 Composer 自身调用链的双重错位。
-
composer.bat必须加到系统变量 Path 中，路径是%PROGRAMDATA%\ComposerSetup\bin（不含文件名），不是php.exe所在目录 - 改完 PATH 后必须关闭所有已打开的 CMD/PowerShell/VS Code 终端，再新开一个——旧进程不会加载新变量
- 验证：
where composer应返回C:\ProgramData\ComposerSetup\bin\composer.bat；where php应指向你期望的 PHP 8.3 目录 - 全局命令（如
laravel）找不到？补上COMPOSER_HOME\vendor\bin到 PATH，路径来自composer config --global home
最常被忽略的一点：缓存不清理，所有配置修改都白做。composer clear-cache 不仅清内存快照，还会删掉 ~/.composer/cache/repo/ 下残留的旧源元数据——这些文件会持续误导后续请求，哪怕你已经切了新镜像、改了 COMPOSER_HOME、甚至重装了 Composer。
