必须升级composer 1.x至2.x，因其已于2022年12月停止维护，导致php 8.1+包安装失败；需用官方脚本重装，禁用self-update，验证三要素并同步更新ci环境。
Composer 1.x 已停止维护，升级到 2.x 是必须的
2023 年 10 月起，composer 1.x 官方正式终止所有支持（包括安全更新），且多数新包（如 laravel/framework v10+、symfony/* v6.3+）已声明不兼容 composer 1.x。你看到的 “Your Composer version is too low” 提示，不是警告，是阻断性错误——安装或更新会直接失败。
如何判断当前版本并确认是否需要升级
运行 composer --version，若输出形如 Composer version 1.10.22 或任何以 1. 开头的版本号，就必须升级。注意：composer self-update 在 1.x 环境下默认只升到最新 1.x 版本（如 1.10.22），不会跨大版本跳转。
- ✅ 正确检测方式：
composer --version | grep "2\."—— 有输出才表示已是 2.x - ❌ 不要依赖
which composer路径判断，很多用户通过curl -sS https://getcomposer.org/installer手动安装，路径可能混用 - ⚠️ Windows 用户若用
Composer-Setup.exe安装，需重新下载新版安装器，旧版安装器不支持自动升级到 2.x
升级命令与关键兼容性变化
执行 composer self-update --2 即可强制升级至 2.x 最新稳定版。升级后最常踩的坑不是命令本身，而是依赖解析逻辑变更：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer install默认启用--no-dev模式（仅当COMPOSER_NO_DEV=1时才生效）？错。实际是：2.x 严格按composer.json的"config": {"platform": {...}}和锁文件精度匹配 PHP/扩展版本，1.x 中被忽略的ext-mbstring缺失现在会直接报错 -
require命令新增--with-all-dependencies，但默认行为已变：2.x 对conflict规则更敏感，以前能绕过的版本冲突现在会中断安装 - 锁文件格式从
composer.lockv1 升级为 v2，旧版composer无法读取 v2 锁文件 —— 团队协作时务必统一版本，否则 CI 会因锁文件解析失败而挂掉
升级后常见报错及快速修复
升级后首次运行 composer install 或 composer update，大概率遇到以下三类错误：
-
Your lock file does not contain a compatible set of packages：删掉composer.lock重生成（仅限开发环境），或先用composer update --dry-run查哪些包被拒绝 -
Package x/y has a PHP requirement incompatible with your PHP version：检查composer.json的"config": {"platform": {"php": "8.1.0"}}是否与当前 CLI PHP 版本一致（php -v），不一致就手动修正 -
Plugin x/y requires composer-plugin-api ^2.0.0, found ^1.1.0：说明插件未适配 2.x，停用该插件（composer global remove x/y）或找其 2.x 兼容分支（如hirak/prestissimo已废弃，无需替代）
迁移不是一次操作，而是验证整个依赖链是否在 2.x 规则下依然成立。尤其要注意私有仓库的 repositories 配置，2.x 对 type: "package" 的 URL 校验更严，HTTP 协议或无证书的 HTTPS 地址会被拒绝。
