“Up to date”却仍是旧版本，大概率因配置了阿里云等镜像源导致缓存误判；需切回官方源再self-update，跨主版本（如升v3）须显式执行composer self-update --3且前提为v2.5+。
composer self-update 为什么说“Up to date”却还是旧版本？
大概率是你配置了国内镜像源（比如阿里云、腾讯云），它们会缓存或代理 https://getcomposer.org/ 的响应，导致 Composer 误判自身已是最新版——它根本没连上官方服务器校验。
- 先临时切回官方源：
composer config -g repo.packagist composer https://packagist.org - 再执行：
composer self-update - 升级成功后，可立刻换回镜像（推荐阿里云）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
想升到 v3，但 self-update 没反应？
composer self-update 默认只在当前主版本内更新补丁（如从 2.5.8 升到 2.5.10），不会跨大版本。v3 是不兼容 v2 的主版本，必须显式指定通道。
- 升级到最新 v3：
composer self-update --3（注意是两个短横线 + 数字 3） - 但前提是你的 Composer 至少是
2.5+，否则不识别--3参数；旧版需先composer self-update升到2.5+再执行 - 确认当前通道和可用版本：
composer self-update --list
Permission denied 或 Signature mismatch 怎么办？
升级失败最常见的三类底层原因：PHP 版本太低、文件权限不足、签名验证失败——self-update 看似一条命令，实则悄悄依赖这三样东西。
- 权限问题（如提示
Could not write to /usr/local/bin/composer）：sudo composer self-update（Linux/macOS）；Windows 建议以管理员身份运行终端 - PHP 版本不满足 v3 要求（v3 需 PHP 8.0+）：运行
php -v确认，不够就先升级 PHP - 签名验证失败（
Signature mismatch）：可能是下载被截断或网络污染，可加-vvv查看详细日志，或手动清理缓存：composer clear-cache
怎么精准控制升级到某个版本？
不是所有场景都要最新版，比如 CI 环境要锁死版本，或项目依赖某旧版 Composer 行为（如 autoloader 生成逻辑）。
- 升到指定稳定版：
composer self-update 2.7.7 - 降级回 v2 最新版：
composer self-update --2 - 尝鲜预发布版（beta/RC）：
composer self-update --preview - 升级后务必验证：
composer --version，再跑一次composer install看是否报错
v3 改动不小，尤其对插件、自定义 installer 和 lock 文件格式有影响；如果项目里用了老旧的 Composer 插件，升级前最好先在测试分支试一遍。
