Composer更新看不到新版本的根本原因是本地缓存的packages.json元数据15分钟内不过期，导致不请求镜像站；应优先用composer update --refresh（≥2.5）刷新元数据，或检查项目级repositories配置是否覆盖全局镜像。
Composer 镜像同步延迟不是你的错，但“明明发布了新版本却装不上”这个问题，90% 是本地缓存没清干净或配置被覆盖导致的，不是镜像站没更新。
为什么 composer update 看不到新版本？
Composer 默认复用本地缓存的 packages.json（15 分钟内不过期），哪怕镜像站已更新，它也读缓存、不发请求。现象是：Packagist 上已显示 monolog/monolog v3.6.0，但执行 composer update monolog/monolog 却提示 “Nothing to install or update”。
-
composer clear-cache会删掉缓存目录，但下次update仍会立刻重建并复用旧packages.json——除非你强制跳过它 - 真正卡点是元数据缓存策略，不是缓存目录是否存在
- 老版本 Composer（2.4 及以下）不支持
--refresh，只能手动删对应 repo 子目录：rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer
怎么确认当前真在用预期的镜像源？
项目级 "repositories" 配置会完全屏蔽全局设置，这是最隐蔽的失效原因。很多人复制的模板里还写着已停更的 https://packagist.phpcomposer.com，结果 composer install 静默 fallback 到官方源，而别人走的是阿里云镜像——同一份 composer.lock 在不同机器上装出不同行为。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查全局镜像：
composer config -g repo.packagist，输出应为完整 URL，如https://mirrors.aliyun.com/composer/ - 查实际生效配置：
composer config --list | grep repositories.packagist.url，确认没被项目级composer.json覆盖 - 验证镜像连通性：
curl -I https://mirrors.aliyun.com/composer/packages.json，HTTP 200 才算通 - 检查项目
composer.json是否含"repositories"字段；若有，删掉或改成有效镜像地址
composer update --refresh 到底干了什么？
这是 Composer ≥ 2.5 提供的精准解法：它只丢弃所有已缓存的 packages.json 和 provider-*.json，重新从当前配置的镜像源拉取最新元数据，但保留 ZIP 包缓存——不重下任何包，只刷新“有哪些版本可用”这个信息。
- 执行后立刻再跑
composer update vendor/package-name，就能看到新版本被识别出来 - 它不会触发依赖图重解析，也不影响
composer.lock结构 - 若你通过环境变量
COMPOSER_REPO_PACKAGIST临时指定镜像，--refresh会按该变量值去拉，而不是config -g的值 - 想绕过所有缓存强制重拉（调试用）：
composer show vendor/package-name --no-cache，能看到真实请求地址
跨国团队构建漂移的根本原因
镜像只缓存元数据，不托管包文件。阿里云北京节点和腾讯云广州节点同步节奏不同，同一时刻查到的可用版本就可能不一致。CI/CD 流水线默认不继承开发者本地配置，如果只靠 composer install，它会 fallback 到官方源，而你的 composer.lock 是在阿里云镜像下生成的——元数据不一致时，Composer 会重新解析依赖图，导致版本升级或降级。
- 正确做法是让所有环境明确知道该用哪个源，并禁用隐式 fallback：在 CI 脚本中显式设置
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 私有包不受镜像影响，但如果
composer.lock里dist.url指向 GitHub Release，而 GitHub 在某些地区访问不稳定，也会造成“同一命令在不同国家失败” - 不要依赖“换更快镜像”来解决一致性问题——直接走
https://packagist.org反而是最简可靠的方案，尤其对跨国协作项目
