执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 可解决90%安装卡顿，但需满足三条件：键名必须为 repo.packagist（非 repos）、type 值 composer 不可省略、URL 必须 HTTPS 且末尾带斜杠；否则静默失效。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能解决 90% 的安装卡顿问题，但这条命令极易静默失效——不报错、不提示，只默默走回 packagist.org。
为什么 composer config -g repo.packagist 总是不生效
它不是“写进去就完事”，而是三个硬性条件缺一不可：
-
repo.packagist键名不能写成repos.packagist（多一个s就彻底忽略） - 中间的
composer是type值，不是可选参数，漏掉就会 fallback 到官方源 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出 404 路径）
验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON。空、null、或仍是 https://packagist.org，说明没成功。
宝塔/CI 构建里镜像配置为啥不起作用
全局配置写在 ~/.composer/config.json，但谁在跑命令，就读谁的配置文件：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 你在终端用
root执行了composer config -g，宝塔「一键部署」却以www用户运行，它读的是/home/www/.composer/config.json - CI 脚本里用
sudo composer config -g，实际写进了root配置，而容器里跑的是runner用户 - Windows 用户路径在
C:\Users\用户名\AppData\Roaming\Composer\config.json，别手写，用命令写入更安全
正确做法：先确认执行用户（比如 whoami 或查日志 UID），再针对性配置，例如：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
项目级配置怎么避免覆盖私有仓库
手动编辑 composer.json 极易出错——引号不全、方括号漏闭、误删已有源。推荐用命令自动合并：
- 进项目根目录，执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加-g） - 如果
composer.json原来是"repositories": {}，命令会 merge 进去；如果是"repositories": []（数组），命令会报错，需先手动改成对象结构 - 千万别写
"packagist": false——这会导致基础包（如php、ext-json）校验失败 - 改完必须运行
composer update --lock，让composer.lock记录新源地址
换源后还是卡在 “Resolving dependencies”
这个阶段完全不走网络，和镜像无关，是 Composer 在本地穷举满足所有约束的版本组合：
- 写了
"*"、"^1.0 || ^2.0"或"minimum-stability": "dev"，求解器会指数级爆炸 -
require-dev里塞了太多工具，尤其含已废弃插件（如fxp/composer-asset-plugin）时，额外请求 Bower/NPM 源，这些源没国内镜像 - PHP 版本约束太宽，比如
"php": "^7.4 || ^8.0"，会让 Composer 尝试大量组合 - 缓存没清：
composer clear-cache必须在换源后立即执行，否则旧元数据还在干扰解析
最常被忽略的是缓存和求解逻辑——镜像只加速下载，不加速依赖解析。卡在这一步，得回头检查 composer.json 的约束写法，而不是换镜像源。
