composer update --refresh是唯一可靠元数据刷新方式，仅composer ≥2.5支持，它删除repo/下packages.json和provider-*.json，强制从当前镜像源重拉索引，保留zip缓存，不解决镜像站未同步问题，但确保本地获取镜像站当前最新元数据。
composer update --refresh 是唯一可靠方式
想让 composer update 完全无视本地已有的元数据缓存、强制从镜像源拉最新索引，必须用 composer update --refresh。这不是“配合缓存”，而是直接绕过所有缓存路径——包括内存残留、~/.composer/cache/repo/ 下的 provider 文件、甚至 vendor/composer/installed.json 的启发式推导。
常见错误现象：
- 运行
composer clear-cache && composer update后，仍没拉到刚发布的v2.1.0版本 -
composer outdated不显示新包，但确认 Packagist 页面已有更新 -
composer update -v日志里没出现Downloading https://...行
关键前提：
- 必须
composer --version确认 ≥ 2.5；否则报错Unrecognized option: --refresh - 若版本旧，先执行
composer self-update - 该命令只刷新元数据（
packages.json、provider-*.json），不重下 ZIP 包，快且安全
为什么 --no-cache 不够用
composer update --no-cache 看似“关缓存”，但它只是跳过磁盘缓存，仍会复用 composer.lock 和 vendor/composer/installed.json 中的旧约束做解析，不保证拉取远程最新索引。它可能仍从旧 packages.json 快照里选包，尤其在私有仓库或镜像同步延迟时，结果不可靠。
典型误用场景：
- CI 构建中用
--no-cache以为能保真，实际依赖图仍是基于几小时前的索引 - 本地开发改了私有包的
packages.json，但--no-cache没触发重新拉取，update还是装老版 - 日志里看不到
Downloading行，说明根本没连远端
验证是否真刷新：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 加
-v运行：composer update --refresh -v - 必须看到类似
Downloading https://mirrors.aliyun.com/composer/packages.json的输出 - 该 URL 取决于当前生效的镜像源，配错源（比如还指向已停用的
https://packagist.org）会导致刷新无效
手动清理 metadata 缓存的补救路径
如果因环境限制无法升级到 Composer 2.5+，或 --refresh 执行失败，需手动清三处：
-
~/.composer/cache/repo/https---packagist.org/（或你配置的镜像路径，如https---mirrors.aliyun.com-composer） -
vendor/composer/installed.json（删掉它，避免 Composer 读取旧快照做推测） -
composer.lock（删掉才能让update重新协商，仅删缓存目录不够）
执行后务必验证：
- 用
composer update --dry-run -v观察是否出现Downloading行 - 若无，检查
composer config repo.packagist.org是否指向有效镜像 - 私有仓库需确认其
packages.json文件可被 curl 直接访问
别碰 vendor/，也别指望它“缓存你的修改”
有人试图通过“改 vendor 里的代码 + --no-cache”来绕过更新覆盖，这注定失败。Composer 把 vendor/ 当作只读缓存区，update 或 install 都会按 composer.lock 或 composer.json 重写全部内容。哪怕你刚改完 vendor/foo/bar/src/Helper.php，下一次命令就清零。
替代方案只有两个真实有效的：
- 临时调试：用
"repositories"+"type": "path"映射本地包目录，改代码不碰vendor/ - 长期修改：Fork 项目、提 PR、或使用官方扩展点（如 Laravel 的 Service Provider 绑定）
最常被忽略的一点：镜像源配置决定 --refresh 刷什么。配成内网 Satis 地址却忘了同步最新包，刷得再勤也没用。
