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 Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 文件。