composer self-update --version X.Y.Z 是最可靠通用的降级方式，可直接下载替换为任意官方发布的稳定版（如2.5.8），无需卸载重装；Windows PowerShell需加引号，权限不足时需sudo或管理员权限，网络失败时应手动下载PHAR。
composer self-update --version 能指定任意稳定版
这是目前最可靠、最通用的版本切换方式，只要目标版本在 https://getcomposer.org/download/ 上发布过（比如 2.5.8、1.10.22），就能直接下载并替换当前 composer.phar。
常见错误现象：composer self-update 2.0.0 报错 “Could not fetch version info” 或卡在 SSL 请求 —— 这不是命令写错了，而是网络无法访问官方源，和参数无关。
-
composer self-update 2.5.8：降级到 v2.5.8（Linux/macOS 普通用户权限足够） -
composer self-update "2.5.8"：Windows PowerShell 下必须加引号，否则.被解析为路径分隔符 - 若提示
Permission denied，说明composer在系统目录（如/usr/bin/composer），需加sudo或以管理员身份运行 - 不推荐用
--preview或--snapshot降级，它们只对升级有效，且不稳定
composer self-update --1 和 --2 已基本失效
这两个参数在 Composer v2.5.0+ 中已被彻底移除；即使你用的是旧版，它们也只对**手动安装、可写路径下的 composer.phar** 有效。绝大多数用户实际用的是 apt/brew/Docker 预装版，二进制文件在只读路径（如 /usr/bin/composer），执行后要么静默失败，要么报 Command "self-update" is not defined。
典型误判场景：which composer 返回 /usr/bin/composer，但 ls -l /usr/bin/composer 显示它是硬链接或符号链接到只读位置 —— 此时 --1 或 --2 不会改变任何东西。
- 别再搜“composer 切换 1.x 和 2.x”，这个说法本身已过时
-
composer self-update --rollback仅回退上一个版本，不可指定，且失败无提示，生产环境禁用 - 如果你真需要 v1，唯一安全做法是
composer self-update 1.10.22（最后一个 v1 稳定版）
包管理器安装的 Composer 不能靠 self-update 升级主版本
通过 apt install composer（Debian/Ubuntu/CentOS）或 brew install composer（macOS）安装的，其二进制由系统包管理器控制，self-update 无权覆盖。哪怕你看到 Upgrading to version 2.x 的提示，也只是虚假日志 —— 实际文件没变，composer --version 仍显示旧版。
- 确认真实路径：
readlink -f $(which composer)，如果输出含/usr/share/composer或/opt/homebrew/Cellar/，说明是包管理器安装 - 正确做法：先卸载，再用官方脚本重装。例如：
sudo apt remove composer && curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - CentOS 用户注意：
yum update composer或dnf update composer通常只更新到极老的 LTS 版本（如 v1.10），不可用于获取 v2
国内网络环境下 self-update 失败的实质原因
self-update 默认从 https://getcomposer.org/version 获取版本信息，再从 https://getcomposer.org/download/ 下载 PHAR。这两个域名在国内常被 DNS 污染或连接超时，和 packagist 镜像无关 —— 设置 composer config -g repo.packagist 对更新命令完全无效。
- 临时绕过（不推荐）：
composer self-update --no-ssl --version 2.5.8（跳过证书校验） - 稳妥方案：手动下载对应版本 PHAR，例如：
curl -sS https://getcomposer.org/download/2.5.8/composer.phar -o /usr/local/bin/composer && chmod +x /usr/local/bin/composer - 若需长期使用，建议把
COMPOSER_HOME设为用户目录，并确保该路径有写权限，避免反复提权
真正容易被忽略的一点：Composer 版本切换从来不是“通道切换”，而是文件替换。所谓“--1/--2”只是历史遗留的误导性命名，现在所有可控操作都应基于明确的版本号（如 2.5.8）或完整重装。路径权限、网络可达性、二进制来源这三者不厘清，任何参数都只是空转。
