composer config -g repo.packagist 没生效是因为键名错（应为单数repo.packagist）、漏type值composer、URL末尾缺/，三者任一出错即静默回退官方源；验证需输出完整JSON或纯URL且-vvv日志中Downloading地址为镜像域名。
直接改 repo.packagist 配置就能提速，但写错键名、漏 composer 类型、URL 缺末尾 /，三者任一出错都会静默失效——命令跑完没报错，composer install 还卡在 Downloading https://packagist.org/packages.json。
为什么 composer config -g repo.packagist 没生效
不是命令失败，而是配置根本没被识别。常见原因有三个：
-
repo.packagist键名写成repos.packagist（多一个s）：Composer 完全忽略该字段 - 命令里漏掉中间的
composer类型值，例如写成composer config -g repo.packagist https://mirrors.aliyun.com/composer/：Composer 5.0+ 会警告Repo is not configured properly，部分包仍走官方源 - URL 少了末尾斜杠，如
https://mirrors.aliyun.com/composer：会拼出错误路径/composerpackages.json，返回 404
验证是否真写进去了：composer config -g repo.packagist 输出必须是完整 URL 字符串或 JSON 对象（如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）。空、null 或还是 https://packagist.org，说明没成功。
全局镜像配置的正确命令和验证方式
执行这条命令即可：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
它会写入 ~/.composer/config.json（Windows 是 %APPDATA%\Composer\config.json），所有项目默认生效。注意三点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 键名必须是
repo.packagist（单数，无s） - 中间的
composer是必填type值，不能省略 - URL 必须以
/结尾，且为 HTTPS
验证是否生效：composer config -g repo.packagist 应输出镜像地址；更可靠的方式是加 -vvv 看真实请求：composer install -vvv 2>&1 | grep "Downloading"，确认域名是 mirrors.aliyun.com 或 mirrors.tuna.tsinghua.edu.cn，而非 packagist.org。
项目级配置优先级更高，怎么避免被覆盖
只要项目根目录 composer.json 顶层有 "repositories" 字段，全局设置就自动失效。这不是 bug，是设计行为。应对方法：
- 进项目目录后先运行
composer config repo.packagist，看是否已有输出；有则说明项目自己写了源 - 想保留私有源又加镜像？别手写 JSON，用命令安全合并：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不带-g） - 如果
composer.json里"repositories"是数组（比如含私有包），命令会失败，需先手动转成对象："repositories": {}
CI/CD 或宝塔环境要注意用户身份：用 sudo composer config -g 写的是 root 的配置，但构建用的是 www 用户，得用 sudo -u www composer config -g 单独配。
换了镜像还是卡在 installing hyperf/cache v3.1.0？
这不是镜像没生效，而是 composer.lock 里记录的是原始 packagist.org 的 dist.url。Composer 会优先尝试这个地址，失败后才 fallback（且不保证成功）。解决方法：
- 执行
composer update --lock强制重写lock文件中的下载链接，让所有包指向镜像源 - 新项目用
create-project时建议加--repository参数直连镜像：composer create-project hyperf/hyperf-skeleton --repository=https://mirrors.aliyun.com/composer/ - 验证是否生效：打开
composer.lock，找任意一个hyperf/xxx包，其dist.url字段应为https://mirrors.aliyun.com/composer/dists/...类路径
镜像只加速包下载，不加速依赖解析——这点最容易被忽略。如果 composer update 卡在 Loading package information，大概率是本地约束冲突或版本回溯过深，换镜像也救不了。
