composer config -g repo.packagist 配置必须同时满足四条件才生效：键名严格为单数 repo.packagist、中间显式指定 composer 为 type 值、url 须 https 且末尾带 /、必须加 -g；任一缺失即静默回退官方源，验证需输出完整 json 对象。
配镜像不是“换地址就行”，composer config -g repo.packagist 这条命令漏掉任意一个硬性条件，就会静默回退到官方源，且不报错——你看到的“还是慢”，大概率是配置根本没生效。
为什么 composer install 卡在 “Loading composer repositories”
这不是网络差，也不是服务器问题。Composer 在安装前必须全量拉取元数据（packages.json），这个请求走 HTTPS，受 DNS 解析、TLS 握手、CDN 节点距离影响极大。官方源在国内平均耗时 20–60 秒，超时后才 fallback，导致卡住。
镜像不是只加速 ZIP 包下载，而是同时替换元数据接口和包分发节点——两者 URL 必须严格匹配，否则会报 Package not found 或 Signature mismatch。
- 清华、阿里、华为云镜像同步延迟通常 ≤5 分钟，稳定性高
-
laravel-china和phpcomposer.com镜像已停用或不再维护，别再用 - 如果项目用了
fxp/composer-asset-plugin（常见于老版 Yii2），它不走 Composer 镜像配置，会额外请求 Bower/NPM 源——这部分无法加速，得升级或迁移
composer config -g repo.packagist 为什么总配不成功
这条命令有三个不可省略的硬性条件，缺一即失效，且无提示：
-
-g必须带：不加就只改当前目录下的composer.json，换项目就失效 - 键名必须是
repo.packagist（单数repo，不是repos；也不能写成packagist.org） -
composer是type值，不是注释或可选参数——漏掉后 Composer 2.x 会直接 fallback 到官方源 - URL 必须是 HTTPS，且末尾必须有
/（例如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404 ❌）
正确示例：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
验证是否生效，运行：composer config -g repo.packagist。输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空、null、报错，或只返回字符串，说明配置失败。
配完镜像还要做这三件事
光改配置不够，Composer 会缓存旧元数据和 dist 包，导致新镜像不生效：
- 运行
composer clear-cache清掉本地缓存（尤其之前用过已停用的phpcomposer.com） - 删掉项目中的
composer.lock和vendor/目录（首次配置镜像时必须） - 再跑
composer install -vvv，确保日志里出现镜像域名（如mirrors.aliyun.com）且无Connection timed out或404
注意：composer.lock 里 "dist": {"url": "github.com"} 如果还是原始地址，说明上次 install 没走镜像，必须删锁重装。
项目级配置怎么避免误删私有仓库
团队协作中，composer.json 里常已有私有包源（比如内部 GitLab 仓库）。手动编辑容易出错，推荐用命令自动合并：
- 进项目根目录，执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加-g） - 如果原
repositories是对象结构（"repositories": {}），命令会转为标准数组并插入packagist条目 - 项目级配置优先级高于全局，所以即使全局配了，也要确认当前项目没覆盖错
真正省时间的地方，是把 composer install 从等两分钟变成等两秒——但前提是你的 composer.json 本身没引入大量 require-dev、嵌套 repositories 或平台不兼容项。这些细节不处理，镜像再快也卡在解析阶段。
