镜像源不参与版本求解，仅缓存元数据；所谓同步延迟是索引文件（如 provider-*.json）更新滞后，非包版本不一致；逻辑版本号由 composer.json 约束与 platform 共同推导，物理版本号锁定在 composer.lock 中。
镜像源不参与版本求解，只缓存元数据
Composer 镜像（如 https://mirrors.aliyun.com/composer/）本身没有“逻辑版本号”或“物理版本号”的概念——它只是对 https://packagist.org 元数据的只读代理。所谓“同步延迟”，本质是镜像站拉取 packages.json 和 provider-*.json 文件的时间差，不是包文件版本不一致，而是索引信息滞后。
常见错误现象：你在本地 composer update 拉不到刚发布的 guzzlehttp/guzzle:7.9.0，但官网页面已显示该版本存在。这不是 Composer 算错，也不是你配置漏了 /，而是镜像还没把 provider-guzzlehttp~7.json 更新过来。
- 验证方式：用
curl -I https://mirrors.aliyun.com/composer/p2/guzzlehttp/guzzle/7.9.0.json对比curl -I https://repo.packagist.org/p2/guzzlehttp/guzzle/7.9.0.json，HTTP 200 vs 404 即可确认是否同步 - 混合云场景下（比如 CI 在 AWS、开发在阿里云 VPC），不同镜像节点可能处于不同同步周期，导致同一时刻查到的可用版本不一致
- 镜像 URL 必须以
/结尾，否则路径拼接错误（如https://mirrors.cloud.tencent.com/composer→ 请求.../composerpackages.json），直接 404
逻辑版本号由 composer.json + platform 决定，物理版本号锁定在 composer.lock
“逻辑版本号”指依赖解析器根据 composer.json 中的约束（如 "^7.5"）、当前 config.platform 声明的 PHP/扩展版本、以及可用元数据共同推导出的**理论最优解**；“物理版本号”则是 composer.lock 记录的实际安装结果，含完整哈希和子依赖树。
二者对齐的前提是：所有机器都用同一份 composer.lock，且 config.platform 显式声明并被严格遵守。镜像源换或不换，不影响这个对齐过程——只要元数据能拉下来，解析结果就唯一。
-
config.platform必须写在composer.json根级config下，例如："platform": {"php": "8.1.10"}；写成"php": "^8.1"或放在extra里均无效 - 改完
platform后必须删掉vendor/和旧composer.lock，再跑composer install，否则旧 lock 仍按原平台解析 - CI 脚本开头加
composer config --global --unset repos.packagist，防止全局镜像覆盖项目级配置，导致元数据来源不一致
多镜像混合使用时，repositories 配置会完全屏蔽全局镜像
只要项目 composer.json 里有 "repositories" 字段（哪怕空数组、哪怕只写了 {"packagist.org": false}），Composer 就彻底忽略 composer config -g repo.packagist 的设置——它不会 fallback，也不会 warning，静默走你写的 URL。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
这在混合云部署中极易引发问题：开发机配了阿里云镜像，CI 用腾讯云镜像，而某人本地 composer.json 里残留着已停服的 https://packagist.phpcomposer.com，结果一部分包走旧镜像 404，另一部分 fallback 到官方源，最终 vendor/ 里混装不同来源的同名包。
- 检查真实生效源：
composer config repo.packagist输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 验证请求域名：
composer show packagist/support | grep "source:"，URL 必须含镜像域名，否则说明配置未生效 - 团队必须统一删除项目级
repositories中所有非必要条目，只保留显式声明的可信源（如私有包源 +packagist.org兜底）
强制“刷新”镜像缓存的唯一有效动作是重拉元数据
不存在客户端命令能“触发镜像同步”。所谓“刷新”，只是让 Composer 跳过本地缓存，重新下载 packages.json 和相关 provider-*.json 文件。这依赖镜像站自身同步进度，无法人为加速。
当遇到版本漂移或 404，最可靠的操作不是清 ~/.composer/cache，而是绕过缓存强制重拉元数据，并切换更稳定的镜像节点。
- 临时强制重拉：
composer clear-cache && composer update --no-cache --dry-run（--no-cache跳过本地校验） - 换镜像调试：
composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/（中科大源同步通常更快） - CI 中避免镜像污染：脚本开头加
composer config --global --unset repos.packagist，结尾加composer config --global repo.packagist composer https://packagist.org复位
真正影响混合云环境一致性的，从来不是镜像快慢，而是 composer.lock 是否提交、config.platform 是否写死、以及 repositories 配置是否被多人随意覆盖——这些点一旦松动，镜像再快也救不了版本漂移。
