根本原因是composer默认复用15分钟内不过期的本地packages.json元数据缓存，导致即使镜像站已更新版本，update仍按旧元数据计算而忽略新版本。
composer update 为什么拉不到新版本
根本原因不是命令失效，而是 Composer 默认复用本地缓存的 packages.json（元数据），15 分钟内不过期。哪怕镜像站上已同步了 monolog/monolog 的 3.6.0 版本，你本地缓存里还存着旧版元数据，composer update 就压根不会去镜像站查——它直接按缓存里的“可用版本列表”做计算。
典型现象：composer update monolog/monolog 显示 “Nothing to install or update”，但你在 packagist.org 和镜像站（如 阿里云镜像）都能确认 3.6.0 已存在。
- 检查当前生效镜像：
composer config -g repo.packagist - 确认缓存路径：
composer config --global cache-dir - 进缓存目录看对应子路径：
ls -l $(composer config --global cache-dir)/repo/，找类似https---mirrors.aliyun.com-composer的文件夹
composer update --refresh 是什么，能不能用
composer update --refresh（Composer ≥ 2.5）是专为解决元数据延迟设计的轻量操作：它只强制丢弃所有缓存的 packages.json 和 provider-*.json，然后从你当前配置的镜像源重新下载最新元数据，不碰 ZIP 包缓存、不重装任何包。
执行后立刻再跑 composer update vendor/package-name，就能识别并安装新版本。它比 composer clear-cache 更精准——后者会清掉整个缓存（包括已下载的 dist 包），而 --refresh 只动元数据层。
- 不支持 Composer 2.4 及更早版本；老版本只能手动删缓存里的 repo 子目录，或临时用
COMPOSER_CACHE_DIR=/dev/null composer update - 确保镜像配置正确：
composer config -g repo.packagist输出必须是你期望的地址（如https://mirrors.aliyun.com/composer/），否则--refresh会去错地方拉 - 项目级
repositories配置会覆盖全局镜像——运行composer config --list | grep repositories确认没被误覆盖
为什么 clear-cache 后还是装旧包
composer clear-cache 清的是 ~/.composer/cache/ 下所有内容，包括元数据、ZIP 包、source 克隆。但它不能保证后续 composer install 或 update 就一定重下 ZIP——因为 Composer 默认仍会优先解压缓存里已有的 dist 包，除非你明确切断这个行为。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真正卡住“重下”的关键点有两个：锁文件约束 + 缓存复用逻辑。即使清了缓存，只要 composer.lock 还在，composer install 就只按 lock 里记录的哈希值还原，连网络请求都可能跳过。
- 想彻底重下所有包：先
rm -rf vendor composer.lock，再composer install --no-cache - 只想重下某一个包：用
composer remove vendor/package-name && composer require vendor/package-name，比update更可控 -
--no-cache不等于“清缓存”，它是本次运行完全忽略本地缓存；和clear-cache是互补关系，不是替代关系
CI/CD 中最常漏掉的关键动作
CI 脚本里写 composer install 并缓存 ~/.composer/cache 很常见，但问题在于：缓存 cache 本身会让后续构建复用旧元数据和旧 ZIP，哪怕 composer.lock 已更新，也未必触发真实下载。
更隐蔽的是，有些 CI 镜像自带预装 Composer 和旧缓存，导致第一次 install 就走捷径。这不是网络或权限问题，是缓存策略和命令顺序没对齐。
- 推荐 CI 写法：
composer clear-cache && rm -rf vendor && composer install --no-cache --prefer-dist --optimize-autoloader --no-interaction - 避免缓存
vendor/目录——它和composer.lock绑定太紧，容易造成环境漂移 - 如果必须用缓存加速，只缓存
~/.composer/cache/，且每次构建前加--no-cache强制校验远程元数据新鲜度
元数据缓存和 dist 包缓存是两层独立机制，强行混用“清缓存”这个词，很容易忽略其中一层。实际调试时，先盯住 packages.json 是否刷新，再看 Downloading 日志是否出现，比盲目重试更有效。
