Composer全局镜像设置推荐使用阿里云镜像，执行composer config -g repo.packagist https://mirrors.aliyun.com/composer/（2.2+）或composer config -g packagist https://mirrors.aliyun.com/composer/（1.x），可提升下载速度与稳定性。
Composer 全局镜像设置（推荐）
国内直接用官方源下载包慢、超时、甚至失败，根本原因是 DNS 污染和网络链路不稳定。全局换镜像最省事，且对所有项目生效。
执行以下命令即可切换到阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意：repo.packagist 是 Composer 2.2+ 的写法；旧版本（如 1.x）需用 packagist（不带 repo. 前缀）：
composer config -g packagist https://mirrors.aliyun.com/composer/
- 执行后会修改
~/.composer/config.json，可手动检查该文件确认"repo.packagist"字段是否已更新 - 如果提示
command not found，说明composer命令未加入 PATH，先确认安装路径或用php composer.phar替代 - 换源后首次运行
composer install或update仍可能卡在「Loading composer repositories」——这是正常现象，耐心等 10–30 秒，不是失败
临时禁用镜像（调试或验证用）
某些包在镜像中同步滞后（比如刚发布的 beta 版），或者你怀疑镜像本身出问题，需要绕过镜像直连官方源。
加 --repository=https://packagist.org 参数即可临时覆盖：
composer require monolog/monolog --repository=https://packagist.org
这个参数只对当前命令生效，不影响配置文件。
-
--repository后必须是完整 URL，不能省略https:// - 如果报错
Invalid repository type: missing 'type' key，说明你传的 URL 不被识别为合法仓库，此时应改用--no-plugins+ 手动删缓存再试 - 不建议长期用此方式，容易漏掉依赖树里其他包的镜像跳转逻辑
项目级镜像配置（多团队协作场景）
团队内部分项目必须用私有包，或需统一锁定镜像源（比如审计要求），这时不应依赖开发者本地全局设置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
在项目根目录的 composer.json 中添加 repositories 字段：
{
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
],
"require": { ... }
}
这样即使开发者没设全局镜像，composer install 也会优先走这个源。
- 务必把
repositories放在composer.json顶层，不要嵌套在config或require里 - 若同时存在全局配置和项目配置，项目级会覆盖全局（Composer 默认行为）
- 如果项目用了私有 Satis 或 Toran Proxy，URL 要写成对应地址，且确保该服务可被 CI 环境访问
镜像失效或 404 的典型表现与应对
阿里云、腾讯云等镜像偶尔会因同步延迟或 CDN 缓存导致包 404，错误信息通常是：
Could not fetch https://mirrors.aliyun.com/composer/p2/monolog/monolog/2.10.0.0-stable.xml, please review your configured sources
这不是你配置错了，而是镜像还没同步完。解决办法很直接：
- 先跑一次
composer clear-cache清掉本地缓存 - 再试
composer update --no-cache强制跳过本地缓存重新拉取 - 如果仍失败，临时切回官方源：执行
composer config -g repo.packagist https://packagist.org，等包发布稳定后再换回来 - 别反复重试同一镜像——不同镜像同步节奏不同，可换用华为云镜像
https://mirrors.huaweicloud.com/repository/php/试试
镜像本质是代理，不是永久备份。遇到 404 别急着怀疑自己配置，先查对应镜像站的「同步状态页」或 GitHub Issue 区，往往已有公告。
