镜像配置不生效主因是未正确设置repo.packagist，Composer 2.2+仅通过该键接管元数据请求；必须严格满足：键名无误、type值为composer、URL以/结尾，且需清缓存并验证JSON输出。
镜像配置不生效，90% 是因为没搞懂 Composer 的元数据请求机制，而不是网络或命令写错了。
repo.packagist 是唯一能接管元数据请求的配置项
Composer 2.2+ 把 packagist.org 当作硬编码权威源，repositories 数组里的条目默认只用于私有包或非 packagist 类型仓库。只有显式设置 repo.packagist，所有元数据请求（比如 packages.json、provider-laravel~10.0.json）才会转向镜像站。
-
composer config -g repos.packagist❌ 多一个s，命令不报错但完全无效 -
composer config -g repositories.packagist❌ 键名错误，Composer 忽略 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/❌ 漏掉中间的composer类型参数，会 fallback 到官方源 - 验证是否生效：运行
composer config -g repo.packagist，输出必须是完整 JSON，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
URL 末尾斜杠 / 不是风格问题，是路径拼接刚需
Composer 内部会把镜像 URL 和固定路径拼起来，例如 packages.json。漏掉末尾 / 会导致拼出 https://mirrors.aliyun.com/composerpackages.json 这种非法地址，部分版本返回 404 或空响应，然后静默回退到 packagist.org。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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.aliyun.com/composer❌ 错误（拼接失败） -
http://mirrors.aliyun.com/composer/❌ 错误（Composer 2.0+ 默认拦截 HTTP） - 华为云镜像地址结构不同：
https://repo.huaweicloud.com/repository/php/，不能把/repository/php/替换成/composer/
项目级配置不是“追加”，而是用户权限与执行环境的现实妥协
全局配置写在 ~/.composer/config.json，只对当前用户生效。但在宝塔、CI、Docker 或 systemd 服务中，实际执行 composer install 的用户往往是 www、runner 或 root，根本读不到你的配置。
- 进项目根目录后执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会修改composer.json的repositories字段 - 如果原
repositories是数组（[]），该命令会失败；需先手动改为对象{}再运行 - 已有私有源时，别用命令覆盖——手动编辑
composer.json，在repositories数组里加一条{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，并确保根节点没有"packagist.org": false - 改完必须运行
composer update --lock，否则composer.lock仍记录旧源地址
卡在 “Resolving dependencies” 和镜像无关
镜像只加速元数据拉取和 ZIP 包下载，不影响依赖解析阶段。这个阶段纯 CPU 计算，靠本地 PHP 解析约束条件。
- 删掉
"minimum-stability": "dev"—— 稳定版直接砍掉 80% 的求解时间 - 收紧 PHP 版本约束：
"php": "^8.1"比"php": ">=7.4"少查几百个包的兼容性元数据 - 临时禁用 xdebug：
php -d xdebug.mode=off $(which composer) install，否则解析慢 5–10 倍 - 确保
composer.lock已提交 Git，并在 CI 中始终用composer install（不是update）
真正容易被忽略的是：镜像配置成功后，composer install 依然慢，大概率是因为缓存目录落在机械盘、WSL2 挂载卷或加密文件系统上——I/O 成瓶颈，跟网络毫无关系。
