镜像配置总不生效是因为 Composer 静默失败，需同时满足三个硬性条件：键名必须为 repo.packagist（非 repos.packagist）、第二个参数必须是 composer（声明类型）、URL 必须以 https:// 开头且末尾带 /；输出需为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 才算成功写入。
镜像配置为什么总不生效
不是 Composer 没反应，是它静默失败了。三个硬性条件缺一不可：repo.packagist（不是 repos.packagist，多一个 s 就彻底忽略）、第二个参数必须是 composer（这是仓库类型声明，漏掉会 fallback 到官方源）、url 必须以 https:// 开头且末尾带 /（https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌）。
验证是否成功：composer config -g repo.packagist 输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或至少是完整 URL 字符串。如果为空、null 或仍是 https://packagist.org，说明完全没写进去。
- 旧版 Composer 1.x 不识别
repo.packagist，得用composer config -g repos.packagist '{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}' - 项目级
repositories字段会覆盖全局配置，进项目目录后执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g）更安全 - Windows 用户别手改
C:\Users\用户名\AppData\Roaming\Composer\config.json，命令写入才可靠
缓存目录放错位置会让 install 慢 2–5 倍
默认缓存路径 ~/.composer/cache 若落在机械盘、WSL2 挂载的 Windows 目录、加密卷或 NFS 上，解压 ZIP 包时 I/O 就成瓶颈。
查当前生效值：composer config --global cache-dir；强制迁移到 SSD 路径：composer config -g cache-dir /mnt/ssd/composer-cache。
- 临时测试是否走新路径：
COMPOSER_CACHE_DIR=/tmp/composer-cache composer install --dry-run，再看/tmp/composer-cache下有没有新文件生成 - 缓存目录必须可写，且不能挂到低速卷上
- CI、宝塔、systemd 里还是慢？你在终端用
root执行了composer config -g，但宝塔后台、CI 脚本、systemd 服务往往以www、git或自定义用户运行，它们读的是各自家目录下的~/.composer/config.json
Resolving dependencies 卡住和镜像无关
镜像只加速下载，不加速依赖解析。这个阶段卡住，和网络无关，典型诱因有：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 || ^8.1"，让求解器暴力试遍所有组合 - 存在
"minimum-stability": "dev"，强制拉取不稳定分支，候选版本数爆炸 -
composer.lock被删或没提交，install实际退化为update - 项目
composer.json中repositories字段指向了已下线私有源，Composer 逐个超时才 fallback
快速排查：composer config --list | grep repositories 看实际生效的是哪个源；再跑 composer validate --strict 确认 lock 文件合法。
composer install 加哪些参数才算真正提速
光换镜像只是第一步，生产环境必加这四个：
-
--no-dev：跳过require-dev（如phpunit），省掉 30–60% 时间 -
--prefer-dist：强制走 ZIP 包，避免git clone的 I/O 和网络开销 -
--optimize-autoloader（或-o）：生成静态类映射，PHP 7.4+ 下可进 opcache -
--classmap-authoritative（或-a）：仅限部署用，告诉自动加载器“没在映射里=真没有”，彻底跳过文件扫描
CI/CD 中推荐组合：composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction --no-progress。注意：--classmap-authoritative 在本地开发中禁用，否则新增类会直接 Class not found。
真正容易被忽略的是：缓存目录权限 + 用户上下文隔离 + composer.lock 是否被提交 + xdebug.mode=off 是否生效——这些点任何一个没对齐，前面所有优化都白做。
