deprecation warning 是 composer 或其插件/依赖包调用已弃用 api 的提示，非错误但预示未来兼容性风险；需通过 -v、--no-plugins 和插件检查定位源头，再升级 composer、插件或调整配置修复。
Composer 的 Deprecation warning 不是错误，但往往预示着你正在使用的包、命令或配置方式即将被移除——它通常来自 Composer 自身（v2.5+）、插件、或依赖包的 PHP 代码中调用的已弃用函数（比如 Package::getNames()、RepositoryManager::getRepository()），而非你的项目代码。解决它不能靠忽略，得定位源头再针对性处理。
为什么 composer install 或 composer update 会突然报 Deprecation warning？
这类警告多数出现在升级 Composer 到 v2.5.x 或更高版本后，因为 Composer 开始更严格地暴露自身 API 的弃用路径；也可能是某个依赖包（如 phpunit/phpunit、symfony/flex）在内部调用了老版 Composer 插件接口（例如 PluginInterface 的旧生命周期方法），而新 Composer 已标记这些为 deprecated。
- 不是所有警告都来自你的
composer.json，很多源自已安装的全局或本地插件（比如hirak/prestissimo、roave/security-advisories） - PHP 的
error_reporting设置会影响是否显示：若启用了E_DEPRECATED（默认开发环境开启），就会输出；生产环境通常关闭，但不等于问题不存在 - 警告本身不阻断执行，但若未来 Composer 彻底移除对应 API，相关插件或脚本将直接崩溃
快速定位警告来源的三个命令
别靠肉眼扫屏——警告常混在大量输出里。用以下组合精准抓出源头：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 加
-v（verbose）让 Composer 输出详细调用栈：composer update -v 2>&1 | grep -A5 -B5 "Deprecated" - 临时禁用插件排查：
composer update --no-plugins；如果警告消失，说明问题出在某个插件，再逐个启用验证 - 检查已安装插件列表：
composer global show --installed（全局）或composer show --plugins（项目级），重点关注维护状态差、两年未更新的插件（如旧版symfony/thanks）
常见可修复场景与对应操作
大多数可解的 Deprecation warning 都落在这几个点上：
-
Composer 版本过旧但插件要求新版 API：升级 Composer 到最新稳定版（
composer self-update），再运行composer update --lock刷新锁文件 -
插件使用了废弃的插件接口：例如警告含
PluginInterface::activate()被弃用，应改用PluginInterface::activate()+EventSubscriberInterface。此时需升级该插件（如将roave/security-advisories升到dev-main或 v3.x）或暂时移除（composer remove roave/security-advisories） -
项目中手动调用了 Composer 内部类：比如在自定义脚本里用了
Composer\Package\CompletePackage，这类属于“非公开 API”，应改用 Composer 提供的稳定事件（如PostUpdateEvent）或通过composer-runtime-api包提供的契约接口 -
PHP 版本不匹配：某些警告（如
ini_set(): Passing null to parameter #2 ($value) of type string is deprecated）实际来自依赖包的 PHP 8.1+ 兼容问题，需检查composer.json中的"config": {"platform": {"php": "8.2.0"}}是否与当前运行环境一致
真正难处理的是那些嵌套在第三方包 composer-plugin 中的警告——它们不会出现在你的代码里，也不在你控制范围内。这种时候，除了提 issue 给上游，唯一稳妥的做法是锁定一个已知兼容的 Composer 小版本（如 composer self-update 2.4.4），并记录下这个技术债。毕竟，warning 不是 bug，但放任不管，下次大版本更新很可能就变成 fatal error。
