composer self-update 默认只升级当前主版本内的小版本（如2.5.8→2.5.12），不跨主版本；升v3需显式执行--3且要求≥2.5.0，PHP须≥8.0；镜像源缓存常致“Up to date”误判，应先切官方源再执行。
composer self-update 默认只升小版本，不跨主版本
执行 composer self-update 不会自动升级到 v3 或 v2.6.0 这类新主版本，它只会拉取当前主版本下最新稳定的小版本（如从 2.5.8 → 2.5.12）。这是默认策略，不是 bug。如果你看到 Up to date 却知道已有 v2.6.0 发布，大概率是镜像源没代理官方版本接口，导致本地比对失效。
解决方法是先切回官方源：composer config -g repo.packagist composer https://repo.packagist.org，再运行 composer self-update。升级完可立刻换回阿里云等镜像源。
- PHP 版本低于 8.0 时，v3 不可用；即使强行
composer self-update --3成功，后续命令也会因语法错误崩溃 -
composer self-update --3要求当前 Composer ≥ 2.5.0，否则参数被忽略或报错 - CI/CD 中建议用
composer self-update 2.5.8显式锁定版本，避免非预期变更
composer self-update --rollback 实际只是文件还原，不是版本回退
composer self-update --rollback 的本质是把当前 composer.phar 替换为同目录下的 composer.phar.backup 文件——它不查版本号、不联网、不校验签名，也不记录历史。所谓“上一个版本”，只是上次 self-update 成功前那个二进制快照。
这意味着：
- 手动下载覆盖过
composer.phar（比如用wget），备份文件不会生成，--rollback直接失败 - 用
apt install composer安装的，二进制在/usr/bin/composer，而self-update只操作~/.composer/vendor/bin/composer或/usr/local/bin/composer，命令完全无效 - 连续升级两次后，第一次的备份已被覆盖，
--rollback只能回到第二次升级前的状态，无法跳回最初版本
想指定降级到某版本，必须用 --version 参数
要可靠地降到 v2.5.8 或 v2.2.20，唯一推荐方式是 composer self-update --version 2.5.8。Windows PowerShell 下注意加引号：composer self-update "--version 2.5.8"。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
但要注意限制：
- v2.5.0+ 才支持
--version参数；旧版只能手动下载 PHAR 替换 - 目标版本低于 v2.5.0 时（如想回退到 v2.2.x），
composer self-update --version会拒绝执行，提示Downgrading to a version older than 2.5.0 is not supported - 国内网络不稳定时，
self-update常卡在https://getcomposer.org；可改用 GitHub Release 链接手动下载，例如：curl -sS https://github.com/composer/composer/releases/download/2.5.8/composer.phar -o /usr/local/bin/composer
回滚后必须验证三处，不能只信终端提示
执行 composer self-update --rollback 或 --version 后，终端显示 “Rolling back…” 或 “Updated” 并不等于生效。真实状态可能没变，尤其当系统存在多个 composer 二进制时。
务必检查：
- 运行
composer --version，确认输出版本号和 commit hash 匹配目标 - 执行
which composer（Linux/macOS）或where composer（Windows），看实际调用的是哪个路径 - 如果项目依赖旧版特性（比如某些插件仅兼容 v2.4.x），需运行
composer install测试是否能正常读取composer.lock
最易被忽略的是：备份文件 composer.phar.backup 一旦损坏或被清理，--rollback 就彻底不可用——它不联网、不重试、不告警，只做一次复制粘贴。真要保障可回退，优先用 --version 显式指定，或提前存好常用旧版 PHAR 文件。
