composer镜像配置失效的三大主因：一是repo.packagist键名必须严格为单数小写；二是type值强制为composer且不可省略；三是url须https并以/结尾。
镜像配置写对了，但 composer install 还是连 packagist.org？大概率不是网络问题，而是配置根本没生效——Composer 会静默 fallback，不报错也不提醒。
为什么 composer config -g repo.packagist 看起来成功却没用
命令执行无提示、composer config -g repo.packagist 输出看似正常，但日志里仍出现 GET https://packagist.org/packages.json。核心原因只有三个，缺一不可：
-
repo.packagist键名必须是单数、小写、无额外字符：写成repos.packagist、repository.packagist或packagist.org全部无效 - 中间的
composer是强制 type 值，不是可选参数，也不能换成git或省略：漏掉它，整条配置被跳过 - URL 必须是 HTTPS 且以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（部分版本拼路径成/composerpackages.json，直接 404）
验证是否真写进去了，只看这一行输出：composer config -g repo.packagist。必须返回类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象；空、null、或只返回 URL 字符串，都说明失败。
项目级 repositories 字段会彻底屏蔽全局镜像
只要项目根目录的 composer.json 里有 "repositories" 字段（哪怕只是 "repositories": [] 或 "repositories": {}），全局配置就完全不生效——不是“优先级低”，是硬编码跳过，且不提示。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查方式：运行
composer config repo.packagist（不带-g），有输出说明项目自己配了；没输出才轮到读全局 - 常见陷阱：
"repositories": []这种空数组，也会触发禁用默认源逻辑 - 安全做法：进项目根目录，手动编辑
composer.json，确保"repositories"是数组，首位为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，已有私有源保留在同一数组中 - 别写
"packagist": false或"packagist.org": false，否则基础扩展（如ext-json）校验会失败
换镜像后 composer install 卡住或报 hash 不匹配
这不是镜像地址问题，而是旧缓存和 lock 文件残留导致 Composer 仍按原路径找包、校验失败。
- 必须先运行
composer clear-cache：旧缓存里存的是官方源 URL 和 hash，不清掉，update可能继续 404 - 删掉
vendor/和composer.lock：lock 文件里的 dist URL 和 hash 来自旧源，和镜像元数据不匹配会导致中断 - 再执行
composer install（不是update）：让 Composer 重新解析依赖、生成新 lock - 临时验证镜像是否可达：
curl -sS https://mirrors.aliyun.com/composer/packages.json | head -n1，比测根路径更可靠
CI/CD、宝塔、容器环境里镜像配置常失效的根本原因
这些环境默认不读你本地终端用户的配置，而是读运行命令的用户（如 www、root 或 CI runner 用户）的 ~/.composer/config.json。
- 宝塔「一键部署」或计划任务默认以
www用户运行，composer config -g却写到了你自己的家目录，压根不生效 - Docker 容器不继承宿主机配置，必须在
RUN阶段显式执行：RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 多阶段构建中，每个含
composer的阶段都要单独配一次，--from=builder不继承配置 - GitHub Actions 等 CI 环境建议加
COMPOSER_HOME环境变量，或直接在 workflow 中跑config -g
最易被忽略的一点：Alpine 镜像默认没有 CA 证书链，即使镜像地址写对了，也会卡在 SSL 校验失败，报 SSL certificate problem: unable to get local issuer certificate。必须加 RUN apk add --no-cache ca-certificates。
