Composer update不显示废弃包警告，是因为镜像源（如阿里云）缓存元数据约15分钟，导致本地未获取到Packagist最新abandoned标记；需执行composer update --refresh（≥2.5版本）强制刷新元数据，或临时切回官方源验证。
为什么 composer update 不显示废弃包警告？
不是包没被废弃，而是你看到的元数据是缓存的旧版本。国内镜像（如阿里云、腾讯云）默认缓存 packages.json 15 分钟，期间即使 Packagist 上已标记 abandoned: true 或填了 replaced by，本地 composer update 仍不会提示——它压根没去拉新元数据。
常见现象包括：
- 刚在 Packagist 页面看到黄色横幅 “This package is abandoned”，但终端执行
composer update完全静默 -
composer show vendor/package输出里没有abandoned字段，或replaced by指向一个早已过时的包 - 切回官方源后立刻出现警告，说明问题出在镜像同步延迟，而非包本身状态
验证方式：composer clear-cache 后再运行 composer show vendor/package —— 这能清掉 provider 缓存，但不强制刷新元数据；真正有效的是 composer update --refresh（仅 Composer ≥ 2.5 支持）。
composer update --refresh 是什么，为什么必须用它？
它不是“重新安装”，而是强制丢弃所有已缓存的 packages.json 文件，只从当前生效镜像源重新下载最新元数据。这是唯一能绕过镜像缓存、让废弃警告“准时抵达”的方式。
注意点：
- 先确认 Composer 版本：
composer --version；≤ 2.4 的老版本不支持该参数，只能手动删缓存目录：rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer - 它不影响已安装的包，也不修改
composer.json，只刷新元数据层 - 执行后若仍无警告，说明该包在当前镜像源的元数据中确实未被标记废弃——这时应临时切回官方源验证：
composer config -g repo.packagist composer https://packagist.org
项目级 repositories 配置如何让镜像失效？
哪怕全局镜像已正确配置（composer config -g repo.packagist.url 返回阿里云地址），只要项目根目录的 composer.json 里存在 "repositories" 字段，Composer 就会优先使用它，完全忽略全局设置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型陷阱：
-
"repositories": [{"packagist.org": false}]—— 表面是禁用 packagist.org，实际连带屏蔽了所有镜像源 -
"repositories": [{"type": "composer", "url": "https://packagist.phpcomposer.com"}]—— 这个旧 URL 已停用多年，但 Composer 不报错，只默默复用本地缓存 - 存在空
"repositories": []，也会触发 fallback 到默认行为（即官方源），跳过你配的镜像
检查命令：composer config --list | grep repositories；修复动作：删掉项目级 repositories 字段，或重写为合法镜像地址。
废弃警告为什么只在 -v 模式下才稳定出现？
Composer 默认把 abandoned 提示归为 notice 级别，和 PHP 的 E_USER_DEPRECATED 一样，默认不输出。它不会中断命令，也不会写入日志，除非你显式加 -v（verbose）或 -vv。
这意味着：
- CI 流水线里跑
composer install若没加--no-ansi -v，根本看不到任何废弃信息 -
composer outdated会标出abandoned包，但它不依赖元数据实时性——它查的是本地 lock 文件记录的状态，可能滞后 - 最准的判断方式仍是：先
composer update --refresh -v，再看输出里有没有Package xxx is abandoned行
真正容易被忽略的，是废弃警告和镜像缓存、项目级配置、输出级别这三层叠加后的静默失效——它不报错，不中断，只悄悄让你继续用一个作者两年前就扔进归档箱的包。
