composer 2.x 的 self-update 命令已移除对 v1 分支支持，--1 参数报错、指定 1.x 版本因硬编码 v2 api 而失败；可靠降级需手动替换 composer.phar 并清理 lock 文件、allow-plugins 和 auth.json。
composer self-update --1 或 --2 为什么经常失效
这不是操作问题，是设计限制。Composer 2.x 的 self-update 命令已完全移除对 v1 分支的支持，执行 composer self-update --1 会报 Unknown option: --1；而 composer self-update 1.10.22 则因请求路径硬编码为 v2 API，返回 Could not find version。它只认自己版本通道里的发布包，跨大版本降级根本走不通。
常见错误现象包括：命令无报错但 composer --version 输出不变、提示 Up to date 却仍是 2.x、或直接拒绝解析版本号。
- Windows PowerShell 中点号会被当作命令分隔符，必须加引号：
composer self-update "1.10.22" -
self-update --rollback只能回退上一个版本，且失败不提示，生产环境慎用 - 即使成功降级，旧版 lock 文件、
allow-plugins字段、token 认证格式仍会导致静默失败
手动替换 composer.phar 是最可靠的方式
本质是换掉被调用的二进制文件本身。先确认当前路径：which composer（Linux/macOS）或 where composer（Windows），再按需操作：
- 下载目标版本（如 1.10.22）：
curl -sS https://getcomposer.org/download/1.10.22/composer.phar -o /tmp/composer.phar - 校验 SHA384（官网提供，跳过则存风险）
- 覆盖安装：
sudo mv /tmp/composer.phar /usr/local/bin/composer && sudo chmod +x /usr/local/bin/composer - 验证：
composer --version应输出Composer version 1.10.22，且composer --help | head -n 3显示明确带 “version 1” 字样
Windows 小皮用户可直接重命名两个目录下的 composer.bat 为 composer1.8.5.bat 和 composer2.5.8.bat，再把两个路径都加入 PATH，即可通过 composer1.8.5 install 显式调用。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
切换后必须清理的三处项目残留
1.x 和 2.x 不兼容不是警告，是硬性阻断。不处理，composer install 会卡在 Loading composer repositories 或直接报 Invalid argument。
- 删掉项目根目录的
composer.lock：2.x 生成的content-hash字段 1.x 完全无法识别 - 删掉
composer.json中的allow-plugins字段：1.x 解析时会触发Plugin installation failed - 检查
auth.json：若含"github-oauth": {"github.com": "xxx"}这类 token 格式，需回退为http-basic形式，否则认证失败
PHP 版本和 Composer 版本必须分开控制
很多人以为切了 Composer 版本就万事大吉，结果 composer install 仍报 This package requires php ^8.1 —— 因为 Composer 实际运行依赖的是 php 命令指向的解释器，不是它自己。
验证方式必须三步一起看：php -v、which php、php -r "echo PHP_BINARY;"。如果 which composer 返回的是 shell 脚本，还要 head -n1 $(which composer) 看 shebang 行是否匹配。
- 临时指定最稳：
/usr/bin/php8.2 /usr/local/bin/composer install - Homebrew 用户注意：
/opt/homebrew/bin/php@8.2 -d memory_limit=-1 /usr/local/bin/composer require monolog/monolog，-d参数必须紧接 PHP 路径后 - 别用
alias composer='php8.2 composer'：Git hooks、Makefile、非交互 shell 中大概率失效
真正容易被忽略的点是：Composer 自身版本切换 ≠ PHP 版本切换，两者独立，且各自有各自的校验逻辑和配置残留。混在一起操作，90% 的失败都源于此。
