Composer 2.5.0+ 已彻底移除 self-update 命令，执行必报“Command 'self-update' is not defined”；唯一有效升级方式是通过官方安装脚本重装：curl -sS https://getcomposer.org/installer | php，再移至 $HOME/.local/bin/composer 并确保 PHP ≥ 8.0。
composer self-update 不是“升级 Composer 的通用方法”，而是仅对官方 PHAR 安装方式有效的自我替换命令；它在 2.5.0+ 版本中已被彻底移除，现在执行只会报 Command "self-update" is not defined。
composer self-update 命令在哪还能用？
只有满足以下全部条件时，composer self-update 才可能成功运行：
- 你用的是官方脚本安装（
curl -sS https://getcomposer.org/installer | php），且二进制文件是直接可执行的composer.phar（不是 Homebrew/apt 的 wrapper 脚本） - 当前 Composer 版本 ≤ 2.4.9 —— 2.5.0 及之后所有版本（包括 2.5.x、2.6.x、2.7.x、2.9.6）都已删除该命令
-
which composer输出的是一个真实可写的 PHAR 文件路径（如$HOME/.local/bin/composer），而非/usr/bin/composer这类系统软链接
如果你运行 composer self-update 得到 Command "self-update" is not defined，这不是网络或权限问题，是命令本身已不存在。别换镜像、别加 sudo、别重试 —— 直接放弃。
为什么 composer self-update 报 Permission denied？
报错 file_put_contents(): failed to open stream: Permission denied 的本质是：你没有写入 $(which composer) 所指文件的权限。常见于：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
sudo curl装到/usr/local/bin/composer，但当前用户不是 root - Homebrew 安装的
/opt/homebrew/bin/composer是只读 wrapper，self-update试图改它却失败 - Windows 下正在运行的
composer.phar被系统锁定，无法覆盖
硬加 sudo composer self-update 会把新二进制属主设为 root，后续 composer install 生成的 vendor/ 目录也归 root，CI 流水线直接崩。正确做法是：用 php composer-setup.php --install-dir=$HOME/bin --filename=composer 重装到用户目录，并确保 $HOME/bin 在 $PATH 前置位置。
现在怎么升级到 Composer 2.9.6 或更高版？
2026 年当前稳定版是 Composer 2.9.6，升级必须走官方重装流程，且有硬性前提：
- PHP 版本必须 ≥ 8.0（
php -v检查），否则新版运行即报ParseError: syntax error, unexpected Attribute - 先清理旧版：
mv $(which composer) $(which composer).bak - 下载并安装：
curl -sS https://getcomposer.org/installer | php→ 生成composer.phar - 移到可执行路径：
mv composer.phar $HOME/.local/bin/composer（确保$HOME/.local/bin在$PATH中） - 验证：
composer --version应输出Composer version 2.9.6，末尾带 commit hash 和日期，不含snapshot或beta
重装后记得恢复镜像源：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ —— 这步容易漏，不设就会回退到慢速官方源。
v2 升 v3 为什么总失败？
composer self-update --3 在 2.5.0+ 已不可用，且 v3 是破坏性大版本：lock 文件结构变更、移除 content-hash、require-dev 信息默认不写入 lock。即使你绕过限制强行装了 v3，首次 composer install 就会报 The lock file does not contain require-dev information。唯一解法是删掉 composer.lock 重建 —— 这意味着依赖解析逻辑已变，不能简单“升级”了事。生产环境目前仍应坚守 2.9.6，v3 尚未正式发布（截至 2026 年 6 月）。
