composer self-update --1和--2失效是因为它们在composer 2.x中已被移除或仅对可写的手动安装版有效；官方不支持跨主版本自更新，必须卸载重装对应版本phar文件并校验sha384。
composer self-update --1 或 --2 为什么经常失效
这两个参数只在 Composer 1.x 时代可靠，2.x 起已逐步弃用。执行 composer self-update --1 时，如果当前已是 2.x，它不会降级，而是静默忽略；若当前是 1.x 但网络或权限异常，也不会报错，只卡住或返回空结果。更麻烦的是 Windows PowerShell 下点号（.）会被解析为命令分隔符，composer self-update --2 实际等价于运行 composer 和 self-update 两条命令，直接失败。
真正起作用的只有：composer self-update 1.10.22（指定完整语义化版本号），且仅对官方发布的稳定版有效。dev 分支、RC 版本、带后缀的构建号（如 2.5.8+github）均不支持。
用完整路径调用不同 composer.phar 是最稳方案
Composer 本质就是个 PHP 脚本，不依赖“切换”逻辑，只认你喂给它的解释器和文件。把不同版本下载为独立文件，直接调用，完全绕过 PATH 冲突和软链维护成本。
- 下载两个版本：
wget https://getcomposer.org/download/1.10.22/composer.phar -O composer-1.10.22.phar，wget https://getcomposer.org/download/2.5.8/composer.phar -O composer-2.5.8.phar - 确保可执行：
chmod +x composer-1.10.22.phar composer-2.5.8.phar - 按需使用：
php composer-1.10.22.phar install或php composer-2.5.8.phar update
这个方式在 CI 脚本、Dockerfile、Makefile 里天然兼容，不需要改环境变量，也不怕终端重启后 alias 失效。
Windows 小皮（PhpStudy）用户怎么自由切版本
小皮默认把不同 Composer 版本装在 D:\phpstudy_pro\Extensions\composer1.8.5\ 和 D:\phpstudy_pro\Extensions\composer2.5.8\ 这类目录下，每个目录里都有一个 composer.bat。关键不是改名字，而是让系统能区分调用：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 把两个目录都加进系统环境变量
PATH（顺序无关） - 重命名各自目录下的
composer.bat：比如改为composer1.bat和composer2.bat - 之后就能直接运行
composer1 install或composer2 update
注意：不要删掉原 composer.bat，否则小皮面板功能可能异常；也不要只加一个目录进 PATH 后靠重命名覆盖——Windows 的 CMD 不支持同名命令多版本共存。
确认当前 composer 真实用的是哪个版本和 PHP
很多人改完以为切成功了，一跑 composer install 还是报错，根本原因是没验证实际执行链。必须分两步看：
第一步，查 composer 自身版本来源：composer --version —— 输出第一行会写明 “PHP 8.2.15 (cli)” 和实际调用的 PHP 路径；第二步，查它用的 PHP 是谁：php -r "echo PHP_BINARY;"，这个值必须和上面一致。如果不一样，说明 which composer 返回的是 shell 脚本，且里面硬编码了 PHP 路径（比如宝塔的 composer.bat 第二行写着 @C:\php\php-7.4\php.exe），此时改 PATH 没用，得直接换解释器调用。
最容易被忽略的一点：composer.lock 文件头部的 content-hash 字段是版本指纹。1.x 锁文件用 "hash"，2.x 改为 "content-hash"。如果你用 2.x 生成了 lock 文件，再拿 1.x 去 install，会直接报错退出，而不是静默降级。
