项目级配置是团队协作唯一可靠方案，必须将镜像配置写入 composer.json 的 "repositories" 对象中，键名为 "packagist"，值含 "type": "composer" 和 https 结尾的 url，且需删除 vendor/ 与 composer.lock 后执行 install。
项目级配置才是团队协作的唯一可靠方案
全局配置 composer config -g 在团队里基本等于没配——CI runner、宝塔的 www-data、Docker 容器内用户，全读不到你本地 ~/.composer/config.json。项目级配置写进 composer.json，才能确保所有人拉代码后行为一致。
操作很简单：进项目根目录（必须有 composer.json），执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动在 composer.json 顶层添加或更新 "repositories" 字段，key 固定为 "packagist"，不会覆盖已有私有源。
- 如果
composer.json里"repositories"是数组（[]），命令会失败；需先手动改成对象（{}）再运行 - 别手写
"packagist.org": false——这会彻底禁用回退机制，镜像一挂，composer install直接失败 - 改完必须删掉
vendor/和composer.lock，再跑composer install（不是update），否则旧 lock 文件仍指向官方源
配置内容必须满足三个硬性条件
哪怕只错一个字符，Composer 就会静默 fallback 到 https://packagist.org，不报错、不提示、日志里还照常显示 “Loading composer repositories…”。
-
repo.packagist是唯一合法键名：不能是repos.packagist、packagist.org或大小写混用 -
composer是必需的 type 值：不是可选参数，也不是注释；漏掉它，整条配置被忽略 - URL 必须是 HTTPS 且末尾带
/：比如https://mirrors.aliyun.com/composer/✅，少斜杠就会拼出/composerpackages.json导致 404❌
验证是否真生效？别信“命令没报错”，直接运行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config repo.packagist
输出必须是完整 JSON 对象：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或只有 URL 没 type，说明没配对。
/etc/composer/config.json 在多用户环境里容易踩坑
某些团队试图用系统级配置统一管理，比如往 /etc/composer/config.json 写入镜像——这理论上可行，但实际落地极难。
-
/etc/composer/目录必须存在，权限755，属主root:root - 文件路径必须严格是
/etc/composer/config.json（不能是/etc/composer.json或其他） -
"repositories"必须是对象，键名必须是"packagist.org"（注意不是"packagist"），值里"type"和"url"同样要满足前述三要素 - Ansible 分发时，别用
sudo -u www-data composer config -g——www-data通常没 shell，命令直接退出
更现实的做法是：CI 流水线中把该文件 COPY 进基础镜像；验证必须切换到真实运行用户：sudo -u www-data composer config repo.packagist，输出应为镜像 URL。
换源后卡住，90% 不是镜像问题
镜像只影响元数据和 ZIP 包下载路径，不参与依赖解析、不解决 PHP 扩展缺失、也不绕过缓存污染。
- 先清缓存：
composer clear-cache - 删掉
vendor/和composer.lock（composer update不会重走镜像流程） - 加
-vvv跑composer install，看日志里请求的是mirrors.aliyun.com还是packagist.org - 如果卡在
Resolving dependencies，和镜像无关——检查composer.json里是否写了宽泛版本约束（如"php": "^7.4 || ^8.0"）、是否引入大量dev-main分支依赖
真正容易被忽略的是：项目里已有的 "repositories" 字段如果是数组形式，或者包含 "packagist.org": false 这类禁用语句，会直接屏蔽所有镜像配置，连验证命令都查不出来。
