配错字符会导致composer install卡在Loading composer repositories；常见错误包括repo.packagist拼写错误、漏写composer参数、URL缺末尾斜杠、全局配置未作用于实际运行用户、未删vendor和composer.lock、Composer 2.2+未禁用packagist.org回退。
配错一个字符，composer install 就会卡在 Loading composer repositories——不是你网速慢，是镜像根本没生效。
为什么 composer config -g repo.packagist 总是没反应
它不报错，但也不工作。90% 的失败就卡在这三处：
-
repo.packagist写成repos.packagist或repositories.packagist：多一个s，Composer 完全忽略，静默 fallback 到https://packagist.org - 漏掉中间那个
composer参数：composer config -g repo.packagist https://mirrors.aliyun.com/composer/是错的；必须写成composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 缺少末尾斜杠：
https://mirrors.aliyun.com/composer❌ 会导致请求拼成https://mirrors.aliyun.com/composerpackages.json，404 后直接退回到官方源
验证是否成功？只看这一行输出：composer config -g repo.packagist。必须返回完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍是 https://packagist.org，说明没写进去。
宝塔、CI、systemd 里镜像失效，其实是用户搞错了
你在终端用 root 执行了 composer config -g，但宝塔「一键部署」跑的是 www 用户，它读的是 /home/www/.composer/config.json，根本看不到你的配置。
立即学习“PHP免费学习笔记（深入）”；
- 查实际执行用户：
sudo -u www whoami或看宝塔任务日志里的 UID - 给对应用户重配：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本别依赖全局配置，改用临时参数更稳：
composer install --repository-url=https://mirrors.aliyun.com/composer/
项目级配置比全局更可靠，但要注意 repositories 格式
进项目根目录运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），它会自动往 composer.json 的 repositories 字段里安全追加，不覆盖已有私有 VCS 源。
-
repositories必须是数组[]，不能是对象{}；写成对象会被 Composer 忽略 - 如果项目已定义私有源（如
"my-git": {"type": "vcs", "url": "https://git.example.com/pkg"}），这条命令会合并进数组，不会清空 - 改完必须删掉
vendor和composer.lock，否则composer install仍按旧 lock 文件里的 dist URL 去下载，完全不走新镜像
Composer 2.2+ 必须显式禁用 packagist.org 回退
哪怕你写了镜像 URL，Composer 2.2+ 仍会静默 fallback 到官方源——除非你在 composer.json 的 repositories 数组第一项写上 {"packagist.org": false}。
- 这一项必须是独立对象，不能和镜像源合并：
{"packagist.org": false, "type": "composer", "url": "..."}❌ 无效 - 正确写法是：
"repositories": [{"packagist.org": false}, {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}] - 少了这句，镜像临时不可用时，
composer install可能混用两个源，导致包版本不一致、校验失败
最常被跳过的动作是删 composer.lock 和确认 repositories 数组结构——这两步不做，前面所有配置都白调。
