Composer自2026年起不再支持self-update命令，因其在2.5.0版本中被彻底移除；必须改用官方PHP安装脚本重装，以确保SHA-384校验与GPG签名验证。
composer self-update 在 2026 年已**不再有效**——它从 Composer 2.5.0 起被官方彻底移除，执行会直接报错：Command "self-update" is not defined。你现在必须用重装式更新替代。
为什么 self-update 突然不能用了？
这不是你环境坏了，是 Composer 团队主动废弃了这个命令。他们改用「官方安装脚本重装」来保证二进制文件的完整性：每次更新都带 SHA-384 校验 + GPG 签名验证，手动下载 composer.phar 替换属于高危操作。
- Composer ≥2.5.0 后，
self-update命令已完全删除，不是“没启用”，是代码里没了 - 如果你还在用旧版（如 2.4.x），升级后首次运行
composer就会提示该命令不存在 - 跨大版本（比如 v2 → v3）更不能靠增量更新——v3 的
composer.lock格式已移除content-hash字段，旧锁文件直接报错
怎么安全重装到最新稳定版？
用官方 PHP 安装脚本覆盖安装，这是唯一被支持的方式。关键点不在“下载”，而在路径、权限和镜像配置是否匹配。
- 先确认当前 composer 所在路径：
which composer（常见路径：/usr/local/bin/composer或/opt/homebrew/bin/composer） - 执行重装命令（以
/usr/local/bin为例）：php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && php composer-setup.php --filename=composer --install-dir=/usr/local/bin/ && php -r "unlink('composer-setup.php');" - macOS Homebrew 用户请把
--install-dir换成/opt/homebrew/bin/；用户级安装推荐--install-dir=$HOME/.local/bin并确保该路径在$PATH前置 - 重装完立刻切回国内镜像（否则默认走官方源，慢且可能失败）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
升级后立刻要检查的三件事
很多人重装完以为万事大吉，结果第一次 composer install 就卡住或报错，问题往往出在这三处。
-
composer --version输出是否 ≥2.7.0？若仍是 2.4.x，说明你重装到了错误路径（比如装到/tmp却没移动，或$PATH还指向旧文件） - PHP 版本是否 ≥8.0？Composer 2.5+ 不再支持 PHP 7.4，升级前务必先确认：
php -v -
~/.composer目录归属是否正确？如果属主是root，新装的 Composer 可能读不到全局配置：ls -ld ~/.composer，必要时运行chown -R $USER:$USER ~/.composer
想升到 v3 怎么办？
v3 是不兼容 v2 的主版本，不是“重装一次”就能自动跳过去。它要求你主动重建依赖图，且接受格式变更。
- v3 安装脚本本身和 v2 不同，必须显式指定通道：
php composer-setup.php --version=3 --filename=composer --install-dir=/usr/local/bin/ - 升级后首次运行
composer install很可能报错：The lock file does not contain require-dev information——这是因为 v3 移除了content-hash，旧composer.lock已失效 - 解决办法：删掉项目根目录下的
composer.lock，再跑composer install；但注意，这会重算全部依赖，务必先git status确认无未提交修改
v3 的兼容性断裂点比想象中多：很多插件还没适配，composer outdated 显示可升，不代表 composer update 能过。真正要升，得一个包一个包地看 composer why-not 和 composer show --tree，而不是指望一条命令全搞定。
