因为-g仅作用于当前用户$HOME/.composer/config.json，而多PHP版本常以不同用户（如www、runner、www-data）运行，读取各自独立的配置文件；phpstudy等集成环境还自带硬编码Composer，无视系统配置。
为什么composer config -g在多PHP版本下经常“配了等于没配”
因为-g不是全局生效，而是“当前用户全局”——它只写入执行命令时的$HOME/.composer/config.json。而不同 PHP 版本常以不同用户身份运行：phpstudy用内置用户、宝塔用www、CI runner 用runner、Nginx PHP-FPM 用www-data，它们各自读取的配置文件路径完全不同。
更隐蔽的是：某些集成环境（如phpstudy）自带独立 Composer 可执行文件，硬编码了工作目录逻辑，完全不走系统 PATH 中的composer，自然无视你配好的~/.composer/config.json。
常见错误现象包括：
-
composer install仍卡在Loading composer repositories from packagist.org - 本地终端装得快，但宝塔后台或 GitHub Actions 报
Could not find package - 明明执行了
composer config -g repo.packagist，composer config -g repo.packagist却返回空或Key not found
composer.json里repositories字段怎么写才真正生效
项目级配置是唯一能绕过用户上下文差异、且与 PHP 版本强绑定的方式。但它对格式极其敏感，错一个字符就静默失效。
立即学习“PHP免费学习笔记（深入）”；
必须满足以下全部条件：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"repositories"必须是数组（[]），不能是对象（{}）；若原为{}，composer config repo.packagist可安全合并；若为[]，该命令会报错，需先手动改为{} - 第一项必须是独立对象：
{"packagist.org": false}，不能合并进下一项（如{"packagist.org": false, "type": "composer"}无效） - 第二项起才是镜像源，
"type"值必须显式写"composer"，"url"必须是 HTTPS 且末尾带/，例如："https://mirrors.aliyun.com/composer/" - 已有私有源（如 GitLab 包）应插在第二项之后，不可删掉第一项
正确结构示例：
{
"repositories": [
{"packagist.org": false},
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
]
}
改完镜像后为什么composer install还是走官方源
镜像只影响元数据下载地址，但 Composer 会优先读取缓存、composer.lock 和已存在的 vendor/。即使你刚改完 composer.json，它仍可能按旧记录往 packagist.org 发请求。
必须执行以下三步，缺一不可：
- 清缓存：
composer clear-cache - 删旧产物：
rm -rf vendor composer.lock - 重装依赖：
composer install（不是update）
注意：composer update不会重读 repositories 配置，它只更新已锁定的包版本；只有 install 会从头解析整个依赖树并使用新镜像。
如何验证镜像是否真实生效
不能只看安装速度变快，要查真实行为：
- 运行
composer config -g repo.packagist—— 若输出为空、null或仍是https://packagist.org，说明全局配置根本没写进去 - 运行
composer diagnose—— 观察 “Repo” 行显示的 URL 是否含镜像域名；若仍是packagist.org，大概率被项目级repositories覆盖或格式错误 - 执行
composer install -vvv—— 日志中首次请求的packages.json地址应为https://mirrors.aliyun.com/composer/packages.json，而非packagist.org
最易被忽略的一点：PHP 版本切换后，composer 命令实际调用的解释器可能未同步。比如你在终端用 php8.2 执行配置，但 CI 脚本里跑的是 php7.4，那镜像虽对，PHP 环境已错——此时装出的 vendor/ 可能不兼容新语法，错误却藏在运行时而非安装阶段。
