Composer安装慢90%因镜像未生效：键名必须为repo.packagist（非repos）、type必须显式设为composer、URL须以/结尾，三者缺一即静默回退官方源；需clear-cache、删vendor与lock文件，并收紧版本约束以解决Resolving dependencies卡顿。
Composer安装依赖网络过慢，90%不是你网速差，而是镜像根本没生效、缓存没清、或配置被覆盖——换源只是第一步，漏掉任意一个条件都会卡在 Loading composer repositories 或反复 connection timed out。
composer config -g repo.packagist 为什么总不生效
这条命令极易静默失败，不报错也不写入。必须同时满足三个硬条件：
-
repo.packagist键名不能写成repos.packagist（多一个 s 就彻底忽略） - 命令中必须显式带上
composer这个 type 值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/；漏掉composer，它就 fallback 回https://packagist.org - URL 必须是 HTTPS 且末尾带斜杠：
https://mirrors.aliyun.com/composer/✅；https://mirrors.aliyun.com/composer❌（少斜杠会拼出/composerpackages.json，直接 404）
验证是否成功：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON，空、null 或仍是 https://packagist.org 都说明没写进去。
换源后还是卡在 “Resolving dependencies”
这个阶段完全不走网络，是 Composer 在本地穷举满足所有约束的版本组合。镜像对它毫无作用。常见诱因：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"php": "^7.4 || ^8.0"这类宽泛约束，触发求解器指数级爆炸 -
"minimum-stability": "dev"让求解器遍历所有 dev 分支元数据 - 项目里写了
"*"或"^1.0 || ^2.0"等模糊版本号，尤其混用时
解决方法不是换源，而是收紧约束：把 * 换成具体版本，删掉 minimum-stability 或设为 stable，再运行 composer update --with-dependencies 观察耗时变化。
为什么 clear-cache 不做就等于白配
缓存里存着旧的 packages.json 和元数据，Composer 会优先读缓存，哪怕配置已改，它仍试图从旧地址拉校验信息——结果卡在 DNS 解析或 TLS 握手，日志里还看不到镜像域名。
- 执行
composer clear-cache是强制刷新元数据通道的唯一可靠方式 - 如果项目已有
vendor和composer.lock，建议一并删掉：rm -rf vendor composer.lock，否则install可能报hash mismatch或no matching package found - CI/CD 或宝塔等环境要注意用户权限：
www用户运行的命令，得用sudo -u www composer config -g ...，否则写进的是/root/.composer/config.json，www根本读不到
还有几个容易被跳过的加速点
镜像 + 清缓存只是基础，真正提速还要看这几项：
- 加
--prefer-dist：强制下 ZIP 包，跳过 Git clone，对大包（如 Laravel、Yii2）效果明显 - 设
parallel-downloads：全局启用并发下载，composer config -g parallel-downloads 10是实测平衡点 - 禁 IPv6：Windows 下常因 IPv6 fallback 卡几秒，临时加
set COMPOSER_NO_IPV6=1 && composer install，或永久设composer config -g use-ipv4 true - 生产环境必加
--no-dev：跳过require-dev，省下 30%～50% 包量和时间
最常被忽略的是：项目级 composer.json 中定义了 repositories 字段，会直接覆盖全局配置。用 composer config --list 和 composer config --list --global 对比，才能确认实际生效的是哪个。
