直接运行composer self-update可升级至最新稳定小版本，但仅限官方安装方式；包管理器安装的需用对应工具升级，否则静默失败或报Permission denied；v2默认不升v3，须显式执行composer self-update --3。
直接运行 composer self-update 就能升级到最新稳定版，但前提是你的 Composer 是官方方式安装的；包管理器（如 apt、brew、宝塔）装的版本基本无法用这个命令升级，强行执行会静默失败或报错。
为什么 composer self-update 没反应或报错 Permission denied
这不是命令错了，而是环境权限或安装路径不匹配：
- 如果
which composer返回的是/usr/local/bin/composer或/opt/homebrew/bin/composer，而你没 sudo 权限，self-update会因无法覆盖文件而失败 - Windows 上常见
Access is denied，因为系统锁住了正在运行的composer.phar；得改用php "C:\path\to\composer.phar" self-update显式调用 - 别急着加
sudo—— 若当初是用curl | php装到$HOME/bin，那加 sudo 反而会让新版本写进系统目录，导致后续插件加载异常 - 更稳妥的做法：重装到用户目录，例如
php composer-setup.php --install-dir=$HOME/.local/bin --filename=composer，再确保$HOME/.local/bin在$PATH前置
composer self-update 默认只升小版本，v2 不会自动变 v3
这是设计使然，不是 bug。v2 和 v3 完全不兼容，锁文件格式、依赖解析逻辑、PHP 版本要求（v3 要求 PHP ≥ 8.0）都变了。
- 默认行为：从
2.7.6升到2.8.0，但不会跳到3.0.0 - 想升 v3？必须显式加参数：
composer self-update --3（注意是两个短横线 + 数字 3） - 旧版 Composer（如 --3，得先
composer self-update升到 2.5+ 再执行 - v3 首次运行
composer install时可能报The lock file does not contain require-dev information，这是因为 v3 移除了content-hash字段，需删掉composer.lock重建
升级后必须立刻验证的三件事
“Updated” 输出不代表真生效，尤其在 CI/CD 或多版本共存环境：
- 运行
composer --version，确认输出里没有snapshot或beta字样（如有，说明误升了开发版，立刻composer self-update回退） - 检查
php -v，v3 要求 PHP ≥ 8.0，若还在用 PHP 7.4，首次运行就会卡在ParseError: syntax error, unexpected Attribute - 执行
composer diagnose，重点看Signature verification failed或CA certificate相关提示 —— v2.2+ 默认启用 GPG 校验，代理或网络劫持会导致更新中止，而非静默降级
真正容易被忽略的是镜像源配置：每次重装或升级后，composer config -g repo.packagist 设置的国内镜像（比如阿里云）不会保留，得手动补上，否则第一次 composer install 就会因连不上 packagist.org 而超时。
