国内主流Composer镜像同步实际很快（5–15分钟），所谓“慢”多因本地元数据缓存未刷新、配置未生效或项目级repositories覆盖全局设置；需用composer config -g repo.packagist验证真实配置，curl检查连通性与版本一致性，并用--refresh强制重拉元数据。
镜像同步慢不是服务端问题，而是客户端配置或缓存机制没对上——国内主流镜像（阿里云、腾讯云、中科大）同步延迟普遍在 5–15 分钟，远快于官方源；所谓“不同步”，90% 是本地没刷新元数据、配置未生效，或项目级设置覆盖了全局镜像。
怎么确认当前真正生效的镜像地址
别信命令输出的“成功”，要查真实写入值。运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果为空、null、报错或仍是 https://packagist.org，说明根本没配进去。
-
repo.packagist写成repos.packagist（多一个 s）会静默失败，不提示也不报错 - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，少斜杠就是 404 - 项目根目录若有
composer.json且含"repositories"字段，它会**完全屏蔽**全局配置；此时得查composer config repo.packagist（不带-g）
为什么改了镜像还拉不到新版包
配置对 ≠ 能用。得验证两点：连得上、数据新。先用 curl -I https://mirrors.aliyun.com/composer/packages.json 看返回是不是 HTTP/2 200；再打开浏览器对比官网和镜像站同包地址（比如 https://packagist.org/packages/topthink/framework 和 https://mirrors.aliyun.com/composer/p/topthink/framework.json），看版本号是否一致。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 镜像站返回 404，但官网已有新版 → 同步卡住（超 30 分钟未更新属异常）
-
composer clear-cache只删 ZIP 和 provider 缓存，不影响packages.json元数据复用逻辑 - Composer 默认 15 分钟内复用本地元数据；想强制重拉，
≥2.5用composer update --refresh，<2.5只能手动删缓存里的repo/子目录
parallel-downloads 和 http-max-concurrent-downloads 到底该设哪个
旧参数 parallel-downloads 已弃用，新版 Composer（2.2+）只认 http-max-concurrent-downloads。设了前者不会报错，但完全无效。
- 执行
composer config -g http-max-concurrent-downloads 10（推荐 8–10，别超 12） - 并发过高容易触发
file_put_contents(/tmp/): failed to open stream错误，CI 环境可先降为 6 - 该参数只加速 tarball 下载，不加速元数据请求；若镜像未生效，它压根没机会并发
- 中科大镜像对 HTTP/2 支持更稳，遇到阿里云偶发 404 时可临时切换
--prefer-dist 被悄悄禁用怎么办
--prefer-dist 是提速关键，但它会被项目级 "prefer-source": true 强行覆盖。这种字段常因协作误提交而存在，查起来容易忽略。
- 进项目根目录，执行
grep -n "prefer-source" composer.json快速定位 - 修复方式：删掉该字段，或运行
composer config --unset prefer-source - 私有包若只提供 Git 地址（无 dist 包），
--prefer-dist会直接报错Could not find a matching version of package xxx，此时只能关掉该参数 - 注意：国内镜像只缓存 dist 包，不缓存 source；镜像失效时，
--prefer-dist会降级为慢速 Git clone
最常被忽略的是元数据缓存周期和项目级 repositories 的覆盖行为——它们不像网络错误那样显眼，但影响更隐蔽、更顽固。
