composer镜像配置失效的根本原因是命令写错导致静默回退官方源：必须同时满足键名repo.packagist（单数）、type值composer、url以https://开头且末尾带/、加-g参数四条件，缺一即失败；验证需输出完整json，换源后须清缓存并删vendor与composer.lock重装。
composer config -g repo.packagist 命令为什么没生效
不是网络问题，也不是镜像不可用，而是命令写错后 Composer 会静默回退到 packagist.org，不报错、不提示。必须同时满足四个硬性条件：
-
repo.packagist是唯一合法键名，写成repos.packagist或repositories.packagist都无效 - 中间的
composer是type值，不是注释，漏掉就整个配置被忽略 - URL 必须以
https://开头，且末尾带斜杠：https://mirrors.aliyun.com/composer/✅；https://mirrors.aliyun.com/composer❌（少斜杠会拼出/composerpackages.json导致 404） - 必须加
-g参数，否则只改当前项目下的composer.json，换目录即失效
验证是否写入成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明根本没写进去。
换源后仍卡在 “Loading composer repositories” 怎么办
这不是镜像没配好，而是 Composer 还在读旧缓存或旧 composer.lock 中记录的元数据地址。它不会自动感知配置变更。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先清缓存：
composer clear-cache - 删掉项目下的
vendor/和composer.lock - 再执行
composer install -vvv，观察日志里第一行Downloading packages.json的域名是否变成mirrors.aliyun.com - 如果 URL 对了但依然卡住，手动测镜像根路径：
curl -I https://mirrors.aliyun.com/composer/packages.json，返回HTTP/2 200才算可用
项目级配置比全局更可靠，怎么安全追加
团队协作或 CI 环境中，全局配置常因用户权限错位（比如宝塔面板用 www 用户跑命令，但 -g 写的是 root 的配置）而失效。项目级配置可 Git 跟踪、行为一致。
- 进项目根目录后执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 这条命令会自动向
composer.json的repositories字段追加 packagist 条目，不覆盖已有私有 Git 源 - 如果
composer.json已有"repositories": []，它会往数组末尾插入新项；如果是空对象{}，会转为标准格式并写入 - 切记别手动编辑 JSON——一个逗号错位就让
composer install直接报JSON decode error
装冷门包时阿里云镜像找不到，怎么临时切回官方源
阿里云镜像只同步热门包，冷门包或新发布版本存在数小时至数天延迟，甚至完全不收录。这不是你配错了，是镜像本身就没这份数据。
- 确认方式：直接访问
https://mirrors.aliyun.com/composer/packagist/xxx/yyy/（如https://mirrors.aliyun.com/composer/packagist/phpstan/phpstan-deprecation-rules/），返回 404 就说明未同步 - 临时切回官方源最安全的做法是用
-d参数单次指定：composer require phpstan/phpstan-deprecation-rules:^1.0 -d'{"repositories": {"packagist.org": {"type": "composer", "url": "https://packagist.org/"}}}' - 或者分两步：
composer config repositories.packagist --unset清掉当前项目自定义源，再composer require xxx/yyy，装完再加回镜像
真正容易被忽略的是：镜像配置生效的前提是元数据能拉下来，而元数据本身依赖 TLS 握手、DNS 解析和 CDN 节点稳定性。哪怕命令全对、缓存已清，若所在网络环境拦截 HTTPS 重定向或证书校验失败（如 cURL error 60），仍会 fallback 到官方源——这时得换镜像地址或调低安全策略，而不是反复重试同一命令。
