Composer全局镜像配置需满足三条件才生效：键名必须为repo.packagist（单数小写无s）、type值必须显式写composers、URL须HTTPS且结尾带/；否则静默失效，仍连官方源。
直接改 repo.packagist 配置就能解决卡顿，但写错任意一个字符——比如少个 /、漏掉 composer 类型参数、或者把键名写成 repos.packagist——都会静默失效，composer install 仍连 packagist.org。
为什么 composer config -g repo.packagist 总是不生效
这不是网络或权限问题，而是 Composer 2.x+ 对全局镜像配置有三个硬性校验，缺一即忽略：
-
repo.packagist必须是单数、全小写、不能带s；写成repos.packagist或repositories.packagist，配置直接被跳过 - 命令中间必须显式带上
composer这个type值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅；漏掉composer就 fallback 到官方源❌ - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅；https://mirrors.aliyun.com/composer❌（拼出路径变成/composerpackages.json，返回 404）
验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或还是 https://packagist.org，说明根本没落地。
换源后仍卡在 Loading composer repositories
这行日志本质是拉取元数据 packages.json，不是下载包本身。旧缓存里存着 packagist.org 的索引文件，Composer 会优先读缓存再尝试校验远程地址——哪怕镜像已配对，它也根本不会发请求到新域名。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须执行
composer clear-cache（不是composer cache-clear，后者已废弃） - 删掉
vendor/和composer.lock，再跑composer install --no-cache强制走新源 - 加
-vvv看真实请求：composer install -vvv 2>&1 | grep "Downloading"，确认出现的是mirrors.aliyun.com或mirrors.tuna.tsinghua.edu.cn，而不是packagist.org
项目级配置比全局更可靠
CI/CD（如 GitHub Actions）、宝塔面板、Docker 容器默认用 www、runner 或 root 用户运行，它们读不到你本地用户的 ~/.composer/config.json。项目级配置写进 composer.json，一提交就同步，行为可预期。
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加-g） - 该命令会自动向
composer.json的repositories字段追加"packagist"条目，不覆盖已有私有源 - 如果项目已有
"repositories": []数组结构，命令会失败；此时需手动编辑，在数组中追加：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 改完后必须运行
composer update --lock，否则composer.lock仍记录旧源的 dist URL，后续安装会 hash 校验失败
Resolving dependencies 卡住跟镜像无关
这个阶段完全不走网络，是 Composer 在本地穷举满足所有约束的版本组合。镜像只加速下载环节（Downloading、Fetching package），对依赖求解无任何影响。
- 如果你发现
composer update卡在Resolving dependencies through SAT超过 10 秒，大概率是约束太宽：比如"php": "*"、"minimum-stability": "dev"、或写了"^1.0 || ^2.0" - 临时关掉 Xdebug：
php -d xdebug.mode=off $(which composer) install，它会让求解慢 5–10 倍 - 检查
config.platform.php是否与实际 PHP 版本匹配；设成"7.4"却在 PHP 8.5 上运行，会触发降级查找逻辑
真正容易被忽略的是：缓存、锁文件、用户权限三者必须对齐。配对错误时，你看到的“卡顿”往往不是网络问题，而是 Composer 在反复重试一个根本不存在的路径。
