必须严格满足三要素：键名repo.packagist（单数）、type值为composer、URL为HTTPS且末尾带/，否则静默失效；验证需输出完整JSON对象，空/null/报错均说明未生效。
composer config -g repo.packagist 命令写对了吗
90% 的 Composer 镜像配置失败，不是网络问题，而是这条命令静默失效——不报错、不提示，但 composer install 依然直连 packagist.org。
必须同时满足三个硬条件：
-
repo.packagist是唯一合法键名，写成repos.packagist（多一个 s）或packagist.org都无效 - 中间的
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，说明没写进去。
换源后 composer install 还慢？先清缓存
镜像配置正确，但 composer install 仍卡在 “Loading composer repositories” 或反复 DNS 解析，大概率是因为旧缓存还在起作用。
composer clear-cache 不是可选步骤，是必须执行的操作：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 缓存里存着旧的
packages.json和元数据，Composer 会优先读缓存，哪怕配置已改，它仍试图从旧地址拉校验信息 - 尤其在宝塔、CI 或计划任务中，缓存路径可能属于不同用户（如
/root/.composer/cache），而实际运行的是www用户，需切用户执行：sudo -u www composer clear-cache - 执行后可加
-vvv看日志确认下载域名是否变成镜像地址（如mirrors.aliyun.com）
项目级配置比全局更可靠
全局配置看着省事，但在团队协作、CI/CD 或宝塔环境中极易失效——因为优先级是：项目级 > 全局 > 默认源。
进项目根目录后，直接运行：
-
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加-g） - 它会自动在
composer.json顶层添加或合并"repositories"字段，key 固定为"packagist" - 如果项目已有
"repositories": {}（对象格式），命令能安全 merge；若已是数组格式（"repositories": []），会报错，需先手动改为对象再重试 - 改完务必删掉
vendor/和composer.lock，再跑composer install，否则旧 lock 文件仍指向海外源
Resolving dependencies 卡住跟镜像无关
这个阶段完全不走网络，是 Composer 在本地穷举满足所有约束的版本组合。换镜像对它毫无影响。
常见真实原因：
- PHP 内存不足（如
memory_limit=128M），临时加COMPOSER_MEMORY_LIMIT=-1测试 - 启用了
xdebug（运行php -v可确认），会让解析慢 5–10 倍；可用php -d xdebug.mode=off $(which composer) install临时禁用 -
composer.json中写了太宽泛的约束，比如"*"、"^1.0 || ^2.0"或"minimum-stability": "dev" -
composer.lock里残留已下线包的引用，导致回退搜索；删 lock 和 vendor 后重装最干脆
真正容易被忽略的是：镜像只加速下载，不解决依赖求解逻辑本身。一旦卡在 “Resolving dependencies”，就得回头检查 PHP 环境和约束写法，而不是继续折腾源地址。
