Composer中文镜像提升ThinkPHP依赖更新速度的教程-composer-PHP中文网

composer全局镜像配置必须严格执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，缺一不可：键名只能是repo.packagist（单数）、中间composer为必填type值、url须https且末尾带/；验证需composer config -g repo.packagist输出完整json对象。

composer中文镜像提升thinkphp依赖更新速度的教程

composer config -g repo.packagist 命令必须写对才生效

写错就等于没换源，所有后续操作都白忙——Composer 2.x 静默 fallback 到 https://packagist.org，不报错也不提示。关键三点缺一不可：

repo.packagist 是唯一合法键名，repos.packagist（多一个 s）或 repositories.packagist 全部无效
中间那个 composer 是 type 值，必须显式写出，漏掉就当配置不存在
URL 必须是 HTTPS + 末尾带斜杠：https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌

验证是否成功只有一条命令：composer config -g repo.packagist。输出必须是 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或纯 URL 字符串。空、null、还是 https://packagist.org，说明根本没写进去。

ThinkPHP 项目该用全局配置还是项目级配置？

本地开发机用全局没问题；但 ThinkPHP 项目一旦进 CI/CD、宝塔、Docker 或团队协作环境，全局配置大概率读不到——因为 ~/.composer/config.json 在 root 下，而 CI runner、www 用户无权读取。

个人开发：执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
团队/部署场景：进项目根目录，运行 composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/（不加 -g），它会自动安全追加到 composer.json 的 repositories 字段，不覆盖已有私有源
宝塔用户务必切用户执行：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

手动编辑 composer.json 极易因逗号错位、引号不闭合导致 JSON decode error，别碰。