Composer 2.5.0+已彻底移除self-update命令，执行会报错“Command 'self-update' is not defined”，必须重装；1.x仅能升至1.10.22，无法跨到2.x；2.4.x及更早2.x可用self-update升小版本。
直接升级 Composer 本身就能解决——但不是所有旧版本都支持 self-update，盲目运行只会卡住或报错。
怎么判断你的 Composer 还能不能用 self-update 升级
先跑这句：
composer --version
结果分三种情况：
- 输出
Composer version 1.x→self-update可用，但最多升到1.10.22，永远上不了 2.x - 输出
Composer version 2.4.x或更早的 2.x →self-update仍有效，能升到当前主版本最新小版本（比如 2.4.9） - 输出
Composer version 2.5.0或更高 →self-update命令已被彻底移除，再执行会报Command "self-update" is not defined，必须重装
顺手加一句：which composer 和 ls -l $(which composer)，确认它是不是软链接指向只读路径（比如 /usr/local/bin/composer.phar），这会影响后续操作权限。
国内镜像导致 self-update 总显示 “Up to date” 却版本很旧
这不是网络慢，是镜像源缓存了官方响应。阿里云、腾讯云等镜像会代理 https://getcomposer.org/，导致 Composer 误判自身已是最新版。
临时切回官方源再升级：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config -g repo.packagist composer https://packagist.org<br>composer self-update
升级完立刻换回镜像（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
别跳过第一步——否则 self-update 就是原地打转。
升级后 composer install 直接崩，大概率是 PHP 版本不兼容
Composer 2.5+ 强制要求 PHP ≥ 8.0。如果你还在用 PHP 7.4，哪怕升级成功，首次运行 composer install 就会卡在 ParseError: syntax error, unexpected Attribute。
验证方式：
- 运行
php -v看 CLI 实际版本（Web SAPI 和 CLI 可能不同，composer走的是 CLI） - 如果 PHP curl -sS https://getcomposer.org/installer | php 手动安装指定旧版（如 2.4.9）
- 注意：某些项目
composer.lock已锁高版本依赖（比如要求 PHP 8.1），即使降级 Composer，install仍会失败——得配合--ignore-platform-req=php临时绕过
升级失败或卡住时，最常被忽略的权限和路径问题
self-update 失败不全是网络或版本问题，很多是权限卡在写入环节：
- 如果
which composer返回的是/usr/local/bin/composer，而该路径属于 root，普通用户无写权限，self-update会静默失败 - 检查
composer是否是.phar文件直链（比如/usr/local/bin/composer是个指向/opt/composer/composer.phar的软链接），后者若只读，升级也会失败 - 稳妥做法：用
curl -sS https://getcomposer.org/installer | php下载新composer.phar，再mv composer.phar /usr/local/bin/composer（需 sudo）
真正麻烦的不是升级动作本身，而是升级后环境是否匹配——PHP 版本、扩展、甚至 composer.lock 里早已锁定的依赖约束，都会在 install 阶段突然发难。
