Composer不会自动替换废弃包，须通过composer show、Packagist页面「Replaced by」字段及GitHub文档三步交叉验证替代项，并手动处理命名空间、方法签名、autoload映射及dev依赖。
Composer 提示 Package xxx is abandoned 不代表不能用，但代表它已停止维护——你得自己找替代、手动换、逐行验证，否则迟早出 runtime 错误。
怎么确认废弃包有没有靠谱替代项
Composer 的警告里写的 Use xxx instead 只是同步 Packagist 页面上作者填的 replaced by 字段，这个字段可能为空、过时，甚至指向 psr/log 这类接口而非具体实现。
- 运行
composer show vendor/package-name，看输出里有没有replaced by:行；若只有abandoned: true，说明没指定替代项 - 打开
https://packagist.org/packages/vendor/package-name，直接看右上角「Replaced by」字段——这才是唯一权威来源 - 若该字段为空，去 GitHub 仓库翻
README.md开头或UPGRADE.md，别在 Issues 里猜 - 注意 PHP 版本兼容性：比如
symfony/polyfill-php81替代某些废弃适配器，但你项目还在 PHP 7.4 就不能直接切
镜像源配置为什么总不生效
命令跑完没报错，但 composer install 还是连 packagist.org？不是网络问题，是三个关键点写错了，且 Composer 静默忽略：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
repo.packagist不能写成repos.packagist（多一个s就完全无效） - 必须显式写出
composer这个type值，漏掉就 fallback 到默认源 URL - URL 必须以
/结尾，例如https://mirrors.aliyun.com/composer/，缺斜杠会导致路径拼成/composerpackages.json直接 404 - Windows 用户改完要重开终端，否则环境变量未刷新，
composer config -g repo.packagist查不到新值
替换包后为什么还报 Class not found
多数废弃包的替代者不只是改名，连 autoload 映射、命名空间、构造函数参数、返回类型都重构过。直接换包名几乎必然失败。
- 检查新包的
composer.json中autoload配置：是否仍映射到src/？命名空间前缀是否一致？不一致就得批量改use语句 - 验证方法签名是否一致：比如
GuzzleHttp\Client从 v6 升 v7，构造参数从array $config变成HandlerStack $handler - 执行
composer dump-autoload -o后必须跑单元测试，尤其验证日志写入、HTTP 请求、上下文传递等基础设施行为是否一致 - 检查新包是否声明了
"replaces": {"old/package": "^2.0"}；有这个字段才可能“无缝”，否则别假设兼容
最常被忽略的是 autoload 冲突：新旧包若注册了相同命名空间（如都声明 "psr-4": {"OldVendor\），类加载器会随机选一个，结果就是有时能跑、有时报错，排查成本极高。
