Composer镜像配置失败主因是composer config -g repo.packagist命令未满足三个硬性条件：键名必须为单数repo.packagist、第三参数必须显式写composer（type值）、URL须HTTPS且末尾带/，缺一即静默回退官方源；验证需输出完整JSON对象，项目级配置更可靠且需同步清理缓存、vendor和composer.lock。
composer config -g repo.packagist 命令为什么总不生效
90% 的镜像配置失败，不是网络问题，是这条命令本身写错了。它必须严格满足三个硬性条件，缺一即静默失效——不报错、不提示、但实际没写进去。
-
repo.packagist是唯一合法键名：写成repos.packagist（多一个 s）、packagist.org或repositories.packagist都无效 -
composer是 type 值，不是注释或可选参数：漏掉它，Composer 2.0+ 会直接 fallback 到官方源 - URL 必须是 HTTPS 且末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，http://...❌，https://mirrors.aliyun.com/composer（少斜杠）❌——后者会导致请求拼出/composerpackages.json404
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或仍是 https://packagist.org，说明根本没写进去。
项目级镜像配置比全局更可靠
全局配置只在你当前终端用户下生效；CI/CD（如 GitHub Actions）、宝塔后台（www 用户）、Docker 构建环境都读不到它。项目级配置写进 composer.json，协作者拉代码后行为一致，优先级还高于全局。
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 该命令会安全追加到
composer.json的"repositories"字段里，key 固定为"packagist"，不会覆盖已有私有源（前提是原结构是对象而非数组） - 如果项目已有
"repositories": []数组形式，别手动覆盖——用命令追加，否则可能误删私有包源 - 改完必须删掉
vendor/和composer.lock，再跑composer install（不是update），否则旧 lock 文件仍指向官方源
国内主流镜像地址与使用差异
阿里云、腾讯云、华为云镜像都可用，但路径和适用场景略有不同，选错可能导致 404 或同步延迟。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 阿里云（推荐首选）：
https://mirrors.aliyun.com/composer/—— 同步及时、稳定性高、路径标准 - 腾讯云：
https://mirrors.cloud.tencent.com/composer/—— 若用腾讯云服务器，可换内网域名https://mirrors.tencentyun.com/composer/，节省公网流量 - 华为云：
https://mirrors.huaweicloud.com/repository/php/—— 实际是 OBS 托管静态镜像，新包同步延迟略高（5–30 分钟），小众包可能暂未收录 - 已停用源勿用：
https://packagist.phpcomposer.com已下线，curl会报Could not resolve host
清华源（https://mirrors.tuna.tsinghua.edu.cn/composer/）响应快，IPv6 支持更稳，适合偶尔测试或备用。
换源后还卡在 Loading 或 Resolving dependencies？
镜像只加速元数据拉取和 ZIP 下载，不解决依赖解析慢的问题。卡在 Loading composer repositories 说明根本没走镜像；卡在 Resolving dependencies 则和镜像无关。
- 卡在
Loading...：先运行composer clear-cache，再删vendor/和composer.lock，最后composer install -vvv观察日志是否出现mirrors.aliyun.com - 卡在
Resolving dependencies：大概率是composer.json写法问题——PHP 版本约束太宽（如"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"）、大量dev-main分支依赖、或本地缓存损坏 - 企业内网或 CI 环境证书校验失败，报
SSL certificate problem: unable to get local issuer certificate：临时加-n参数跳过（composer install -n），长期应部署内部代理或证书白名单 - 镜像同步有延迟，新包搜不到：先查
https://mirrors.aliyun.com/composer/packagist/是否已收录；若网页能搜到但 CLI 报错，清缓存重试
最常被忽略的点：改了镜像却没清缓存、没删 composer.lock，结果 Composer 还在按旧文件里的官方 URL 去请求——表面换了源，实际没走。
