Composer镜像配置不生效主因是三个硬性条件缺一不可：键名必须为单数repo.packagist、type值必须显式写composer、URL必须HTTPS且末尾带/；任一错误即静默回退官方源，验证需输出完整JSON对象。
Composer 镜像配置不生效，90% 是因为 repo.packagist 键名、composer type 值、HTTPS 末尾斜杠这三处写错任意一个，就会静默回退到 packagist.org，连 warning 都不报。
为什么 composer config -g repo.packagist 总是没反应
它不是卡住或失败，而是根本没写进去——Composer 2.0+ 对这三个字段做硬校验，缺一即忽略整条配置：
-
repo.packagist必须是单数，repos.packagist、packagist.org、repository.packagist全部无效 - 中间的
composer是强制 type 值，不能省略，也不能替换成https、composer.org或其他字符串 - URL 必须是 HTTPS 且末尾带
/：比如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404，然后静默 fallback
验证是否真写进去了？别信终端没报错，直接运行：composer config -g repo.packagist。输出必须是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或提示 Key does not exist，说明完全没生效。
项目级配置比全局更可靠，尤其在 CI 和宝塔中
全局配置（加 -g）只写进当前用户的 ~/.composer/config.json，但 GitHub Actions 用 runner 用户、宝塔后台用 www 用户、Docker 容器用默认非 root 用户——它们都读不到你的配置。
进项目根目录（确保有 composer.json），执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动在 composer.json 的 repositories 字段里安全写入 "packagist" 条目：
- 如果原
"repositories": {}（空对象），会转为标准数组并插入 - 如果已有私有源（如
"type": "vcs"），会追加到数组末尾，不破坏结构 - 但如果原
"repositories": []（空数组），命令会静默失败；需先手动改成{}再重试
改完必须删掉 vendor/ 和 composer.lock，再跑 composer install（不是 update），否则旧 lock 文件仍记录官方源的 dist URL，install 根本不走新镜像。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
换源后仍卡在 “Loading composer repositories” 怎么快速定位
这不是镜像地址问题，而是请求压根没发到你配的地址——Composer 还在读缓存或旧元数据。
排查顺序必须严格：
- 先运行
composer diagnose，看 “Repo packagist is private” 是否出现，以及 “Repo packagist.org” 行是否显示为你配的镜像 URL - 再执行
composer clear-cache清掉本地缓存 - 删掉项目下的
vendor/和composer.lock - 最后用
composer install -vvv 2>&1 | grep "Downloading"观察日志，确认域名是mirrors.aliyun.com而非packagist.org
如果日志里仍有 packagist.org，立刻检查 composer.json 里是否存在 "repositories" 字段（哪怕只写了 {} 或 {"packagist.org": false}）——只要这个字段存在，就会完全屏蔽全局配置。
换源后 composer install 报 hash 不匹配？删锁文件是硬性步骤
这不是网络超时或权限问题，是旧 composer.lock 里记录的包哈希和 dist URL 来自官方源，切换镜像后 Composer 仍按原路径去阿里云找 zip 包，但镜像服务的内部路径映射与 packagist.org 不同，校验必然失败。
必须执行这三步：
- 删掉项目下的
vendor/目录 - 删掉
composer.lock文件 - 再执行
composer install（不是update），让 Composer 重新解析依赖、生成适配新镜像的 lock 文件
顺手加 -vvv 观察日志，确认所有 Downloading 请求都发往镜像域名。漏掉任何一步，都可能继续走海外源或校验失败。
