composer config -g repo.packagist 命令必须严格满足三条件才生效：键名唯一为 repo.packagist（非 repos）、composer 为强制 type 值、URL 必须 HTTPS 且末尾带 /；否则静默回退官方源，验证需输出完整 JSON 对象。
composer config -g repo.packagist 命令必须写对
配错就等于没配，而且 Composer 不报错、不提示，静默失效。最常见错误是键名写成 repos.packagist（多一个 s），或漏掉 composer 这个 type 值，或 URL 少了末尾斜杠 /。
正确命令只有一条（以华为云为例）：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/
-
repo.packagist是固定键名，不能是repos、repository或其他变体 -
composer是 type 值，必须显式写出，不能省略 - URL 必须用
https://开头，路径必须是/repository/php/composer/（注意中间层级和结尾斜杠） - 如果提示
Command 'config' is not defined，说明 Composer 版本太老，先运行composer self-update
验证是否生效：直接执行 composer config -g repo.packagist，输出应为完整 JSON 对象，例如：
{"type": "composer", "url": "https://mirrors.huaweicloud.com/repository/php/composer/"}
如果为空、null 或报错，说明配置根本没写进去。
项目级 repositories 会彻底屏蔽全局镜像
只要当前目录下 composer.json 里有 repositories 字段，全局配置就自动失效——哪怕它是个空对象 {}，或者写成数组格式 []，都会导致失败。
检查方式很简单：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
cat composer.json | grep -A5 repositories，确认是否存在该字段 - 如果存在，且里面 key 是
"packagist"，那它就是最高优先级源；如果不是"packagist"（比如叫"huawei"），Composer 根本不会识别为默认源覆盖 - 临时禁用项目级配置：用
composer config --unset repos.packagist（注意是repos，不是repo）
多人协作时更推荐直接在 composer.json 中写入合法结构，避免环境不一致：
{
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.huaweicloud.com/repository/php/composer/"
}
}
}
换源后还是慢？重点查这三件事
镜像只解决“下载”环节，但卡顿可能来自其他地方。别一慢就怀疑镜像本身。
- 并发线程太少：
composer config -g parallel-downloads 8（Composer 2.2+ 支持），默认只有 3，带宽利用率极低 - 缓存路径不可写或未启用：
composer config -g cache-files-dir ~/.composer/cache/files，再确认该路径有写权限 - 旧缓存干扰：
composer clear-cache，尤其之前用过已下线的腾讯云源，缓存里可能存着失效的元数据
如果 composer install 卡在 Resolving dependencies 阶段，和镜像完全无关——那是 PHP 版本约束太宽、dev 包太多、或 composer.json 写法导致的解析开销大。
华为云镜像同步有 5–30 分钟延迟
新发布的包不会实时同步到华为云镜像，首次尝试安装可能遇到 404 错误，例如：
The "https://mirrors.huaweicloud.com/repository/php/p2/vendor/package/1.2.3.json" file could not be downloaded (HTTP/2 404)
这不是你配错了，而是镜像还没拉到最新数据。此时可临时切阿里云源（同步更快）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
不建议手动删 composer.lock 或 vendor 强行重装——依赖一致性会被破坏。等十几分钟再试，或换源后跑一次 composer update --dry-run 看是否能正常解析。
