Composer全局镜像配置生效需同时满足三个硬性条件：键名必须为单数repo.packagist、type值必须显式指定为composer、URL须以https://开头且末尾带/，任一缺失即静默回退官方源，验证输出必须为完整JSON对象。
生产环境部署慢，八成卡在 composer install，不是网络差，也不是代码问题，而是镜像没配对、参数漏了、缓存没清——三者缺一，提速就成空谈。
composer config -g repo.packagist 为什么总不生效
这条命令看似简单，但错一个字符就静默回退到 https://packagist.org，且完全不报错：
-
repo.packagist不能写成repos.packagist（多一个s就彻底失效） - 必须显式带上
composer这个 type 值：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - URL 必须是 HTTPS 且末尾带
/：https://mirrors.cloud.tencent.com/composer/✅，https://mirrors.cloud.tencent.com/composer❌ - 漏掉
-g就只改当前项目，换目录即失效
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}。空、null、或仍显示官方地址，说明没写进去。
CI/CD 中 composer install 还卡在 Resolving dependencies
镜像只加速下载，不加速依赖解析。这个阶段卡住，和网络无关，典型原因有：
-
composer.json里写了过宽的 PHP 版本约束，比如"php": "^7.4 || ^8.0 || ^8.1"，触发求解器暴力穷举 - 存在
"minimum-stability": "dev"，强制拉取不稳定分支，候选版本爆炸 -
composer.lock被删或未提交，install实际退化为update -
repositories字段指向了已下线的私有源，Composer 逐个超时才 fallback
快速排查：进项目根目录，执行 composer config --list | grep repositories 看实际生效源；再跑 composer validate --strict 确认 lock 文件合法。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
部署脚本里必须加的四个参数
光换镜像只是第一步，生产环境必须同时带上这四个参数，缺一不可：
-
--no-dev：跳过require-dev包（如phpunit），省掉 30–60% 时间，也避免调试入口混入线上 -
--prefer-dist：强制走 ZIP 包，避免git clone的 I/O 和网络开销；但前提是镜像已生效，否则会 fallback 到慢速 source -
--optimize-autoloader（或-o）：生成vendor/composer/autoload_classmap.php，类加载从平均 1.2ms 降到 0.05ms -
--classmap-authoritative（或-a）：告诉 autoloader “没在映射里 = 真没有”，彻底跳过文件扫描；漏掉它，--optimize-autoloader几乎无效
CI/CD 推荐完整写法：composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction --no-progress。注意：--classmap-authoritative 在本地开发中禁用，否则新增类直接 Class not found。
为什么删了 vendor 和 composer.lock 后还要 clear-cache
镜像配置生效后，旧缓存里的元数据（比如 packages.json）仍指向 packagist.org，Composer 会优先读缓存，根本不发新请求：
- 执行
composer clear-cache是硬性步骤，否则install仍走海外地址 - 项目级配置可能覆盖全局，用
composer config --list和composer config --list --global对比确认实际生效的是哪个 - 某些包硬编码 GitHub URL（如
"dist": {"url": "https://github.com/xxx/yyy/archive/"}），这类不会走镜像，会撞上 GitHub Rate Limit；报错含GithubRateL就是它
真正卡住时，唯一能确认镜像是否命中的方式是加 -vvv：日志里出现 GET https://mirrors.cloud.tencent.com/composer/p2/ 才算成功。别信“命令跑完了”，得看 HTTP 请求地址。
