最常见错误是 composer config -g repo.packagist 配错地址或作用域，导致下载慢、404/500 错误；2026 年应使用阿里云、腾讯云、华为云等 HTTPS 全量镜像，并通过 composer show -v 验证真实请求地址。
composer config -g repo.packagist 这条命令配错地址或用错作用域，是导致依赖下载仍慢、甚至 composer install 报 404 或 500 错误的最常见原因。国内主流镜像在 2026 年已全部切换为 HTTPS + 全量同步，但旧地址（如 packagist.phpcomposer.com）多数已失效或仅作跳转，实际应优先使用阿里云、腾讯云、华为云等仍在 actively maintain 的镜像。
怎么确认当前用了哪个镜像
执行 composer config -g repo.packagist，如果输出为空，说明没设全局镜像，走的是官方源；如果输出类似 https://mirrors.aliyun.com/composer/，说明配置生效。注意：该命令不显示“未启用”状态，只显示已设置的值。
更可靠的验证方式是加 -v 参数触发一次真实请求：
composer show -v | head -n 5
观察日志里出现的 Downloading https://... 域名，这才是真实请求地址。
- 输出含
packagist.org→ 没生效或被覆盖 - 输出含
aliyun.com/tencent.com→ 镜像正常 - 输出含
phpcomposer.com或laravel-china.org→ 地址已过期，大概率会卡住或报错
全局镜像配置的正确写法（2026 年有效）
别再抄老教程里的失效地址。以下三个是目前（2026 年 4 月）经实测可稳定访问的全量镜像，任选其一即可：
- 阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 华为云：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/
⚠️ 注意事项：
- 命令中
repo.packagist是固定键名，不能写成repos.packagist（少个 s）或packagist.org -
composer是 type 字段值，必须小写、不能省略 - URL 末尾的
/推荐保留，部分镜像服务对路径严格匹配 - Windows 用户若提示权限错误，先以管理员身份运行终端，或改用项目级配置
项目级镜像配置（适合多团队协作或 CI 环境）
全局镜像虽方便，但在企业 CI/CD 或混合网络环境里容易引发不可控行为。推荐在项目根目录下执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这会在当前项目的 composer.json 中自动添加 repositories 字段，内容类似：
{"repositories": {"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}}
好处是：
- 所有协作者 clone 后无需额外配置，
composer install自动走镜像 Git 提交后，CI 流水线也默认生效
- 不会干扰其他项目的源配置
取消项目级配置用：composer config --unset repositories.packagist
镜像失效时的快速回退方案
如果某天发现 composer update 卡在 downloading 或返回 Connection refused，先别重装 Composer —— 大概率是镜像临时不可用。直接执行：
composer config -g --unset repos.packagist
这条命令能清掉全局镜像设置（注意是 repos.packagist，不是 repo.packagist），让 Composer 回退到默认源。等镜像恢复后再重新配置即可。
真正容易被忽略的点在于：config -g 和 config 修改的是不同层级的配置文件，且 --unset 的 key 名不一致；混用会导致你以为删了，其实还残留着。建议每次修改后都用 composer config -g -l 查看完整列表确认。
