执行 composer self-update 即可升级到最新稳定版，该命令全局生效、不依赖 composer.json，国内可加 --mirror 指定阿里云镜像；权限错误时应重装至用户目录而非硬加 sudo。
执行 composer self-update 就能升级到最新稳定版
默认情况下，composer self-update 会从官方镜像拉取最新稳定版本（非预发布），覆盖当前安装的二进制文件。它不依赖项目中的 composer.json，是全局生效的独立操作。
- 运行前建议先确认当前版本：
composer --version - 普通用户执行即可，无需
sudo（除非当初用sudo curl手动安装到/usr/local/bin） - 如果提示权限错误，说明 Composer 被装在系统级路径且当前用户无写入权限，应改用
curl -sS https://getcomposer.org/installer | php重装到家目录再配置$PATH - 国内网络直连可能超时，可加
--mirror https://mirrors.aliyun.com/composer/指定镜像（注意：该参数仅对下载有效，不改变包源）
升级失败常见报错及对应解法
最常卡在「Permission denied」或「Could not write to /usr/local/bin/composer」——本质是文件所有权/路径写入权限不匹配，不是 Composer 自身 bug。
-
file_put_contents(/usr/local/bin/composer): failed to open stream: Permission denied：说明你没权限覆盖系统路径下的文件，别硬加sudo，容易破坏后续插件加载；推荐改用php composer-setup.php --install-dir=$HOME/bin --filename=composer重装到用户目录 -
SSL certificate problem: unable to get local issuer certificate：PHP 缺少 CA 证书包，临时可加--no-verify（不推荐长期用），更稳妥的是配置openssl.cafile或更新系统 ca-certificates 包 - 升级后
composer命令失效：检查$PATH是否仍包含旧路径，或执行hash -d composer（bash）清 shell 缓存
想升级到开发版或指定版本？得加参数
稳定版满足绝大多数人需求，但如果你在调试 Composer 本身、或需要某个未发版的修复，就得主动指定通道或版本号。
- 升级到最新 snapshot（每日构建）：
composer self-update --snapshot，适合测试新功能，但可能不稳定 - 回退到特定稳定版本：
composer self-update 2.5.8，版本号必须精确匹配发布页上的 tag（如2.5.8，不能写^2.5） - 升级到预发布版（alpha/beta/rc）：
composer self-update --preview，仅当明确需要尝鲜时用 - 所有带参数的升级都会跳过本地校验，直接下载对应 zip 包，因此首次运行稍慢
CI/CD 环境里自动升级要格外小心
CI 流水线中执行 composer self-update 很常见，但容易引发非预期变更，尤其当多个 job 共享缓存或容器镜像时。
- 不要在 Dockerfile 中写
RUN composer self-update—— 镜像构建时间固定，但实际运行时 Composer 可能已更新，导致环境不一致 - 推荐做法：在 CI 脚本开头显式固定版本，例如
composer self-update 2.5.8，避免因上游版本漂移导致构建失败 - GitHub Actions 等平台若使用
php-actions/composer这类 action，其内部已封装版本控制逻辑，此时再手动self-update反而可能冲突 - 某些共享 runner 上，
self-update可能被管理员禁用（如返回Command disabled in this environment），这时只能靠镜像预装或下载二进制覆盖
