Composer 自 v2.5.0 起已彻底移除 self-update 命令，改用官方安装脚本覆盖重装；升级前须确认 PHP ≥ 8.0、镜像源配置及 ~/.composer 权限归属。
Composer 已经没有 self-update 命令了——从 v2.5.0 起，它被官方彻底移除。你现在运行 composer self-update 会直接报错：Command "self-update" is not defined。这不是你装错了，也不是网络问题，是 Composer 团队主动改了更新机制：不再支持“原地升级”，只允许“重装式更新”。
为什么 self-update 突然失效了？
官方在 2026 年初明确弃用该命令，核心原因是安全与可维护性：Phar 文件的增量 patch 升级容易出校验失败、签名绕过、权限残留等问题。现在所有更新都必须通过官方安装脚本重新下载完整二进制，确保一致性。
- Composer 2.5+（含当前最新稳定版）已完全删除
self-update子命令 - 旧版文档或 CI 脚本里还留着这行，就会在 2026 年 3 月后批量崩掉
- 不是 bug，是设计变更；强行降级 Composer 来“恢复”这个命令，反而会引入 PHP 8.0+ 兼容性风险
现在怎么升级 Composer 到最新稳定版？
唯一可靠方式：用官方安装器覆盖重装。注意路径和权限，别让 sudo 搞乱你的用户环境。
- 全局重装（推荐）：
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
- 用户级重装（更安全，免 sudo）：
curl -sS https://getcomposer.org/installer | php -- --install-dir=$HOME/.local/bin --filename=composer
，并确认$HOME/.local/bin在$PATH中靠前 - CI/CD 流水线中务必加
--no-interaction参数，否则卡住超时：curl -sS https://getcomposer.org/installer | php -- --install-dir=/tmp --filename=composer && mv /tmp/composer /usr/local/bin/composer
升级前必须检查的三件事
漏掉任何一项，重装完可能立刻报错或静默失败。
-
PHP 版本：Composer 2.5+ 要求
PHP ≥ 8.0；如果你还在跑PHP 7.4，重装后首次运行就崩在Attribute语法上——先升 PHP，别硬刚 Composer -
镜像源配置：如果之前设过阿里云镜像（
https://mirrors.aliyun.com/composer/），重装后默认走官方源；如需继续用镜像，重装完立刻执行：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
-
权限归属：如果
~/.composer目录属主是 root，新装的 Composer 可能读不到全局配置；用ls -ld ~/.composer检查，必要时sudo chown -R $USER:$USER ~/.composer
最麻烦的从来不是哪条命令敲得对，而是 PHP 版本、文件权限、镜像策略这三样东西——它们不报错，但会让 Composer 表现异常，而且很难一眼定位。
