composer 2.2.0+ 已彻底移除 self-update 命令，执行即报“command not defined”，主因是官方为保障 ci/cd 和容器化部署的安全稳定而主动废弃该机制；替代方案须按安装方式选择：手动安装用官方脚本重装，包管理器安装则用对应命令升级。
composer self-update 为什么现在经常失败或报错
不是你操作错了，而是 Composer 2.2.0+ 默认禁用 self-update 命令本身——它已从二进制中移除，执行时直接报 Command "self-update" is not defined. 或 The "self-update" command has been removed.。这不是权限、网络或拼写问题，是官方主动废弃该机制。
根本原因是安全与稳定性风险：自动更新可能破坏 CI/CD 流水线、容器镜像一致性，甚至导致锁文件解析逻辑不兼容。尤其在 GitHub Actions、GitLab CI 中硬写 composer self-update 会直接构建失败。
- Windows 用户用
composer-setup.php安装的，self-update从 v2 起彻底不可用 - Mac/Linux 用
curl -sS https://getcomposer.org/installer | php安装的，也不再响应该命令 - 通过
brew、apt、apk等包管理器安装的，self-update本就不支持
如何安全地更新 Composer（替代 self-update）
必须根据你的安装方式选对应方案，别复用旧文档里的 composer self-update。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 手动安装（推荐）：用官方脚本重装指定版本，路径要和
which composer输出一致php -r"copy('https://getcomposer.org/installer', 'composer-setup.php');"php composer-setup.php --filename=composer --install-dir=/usr/local/bin/rm composer-setup.php - CI/CD 场景：用
COMPOSER_VERSION环境变量控制版本，避免拉到不稳定快照版curl -sS https://getcomposer.org/installer | php -- --version=$COMPOSER_VERSION --install-dir=/tmp --filename=composerexport PATH="/tmp:$PATH" - Docker 构建：别在
RUN composer self-update，改用apk add php-composer（Alpine）或apt-get install php-composer（Debian）
回滚只对特定场景有效：self-update --rollback 的真实能力边界
composer self-update --rollback 不是万能回退开关，它只在你**用 self-update 成功升级过一次**的前提下才可用，且仅能回滚到上一个版本——不是任意历史版本，也不是多次升级后的“最初版本”。
- 依赖本地单个备份文件，不联网、不校验、不查发布记录
- 连续升级两次（v2.5.8 → v2.6.0 → v2.6.1），再执行
self-update --rollback只能回到 v2.6.0，不是 v2.5.8 - 如果你手动下载
composer.phar替换过，或用包管理器安装，这个命令直接失效 - 回滚后务必运行
composer --version确认，别只信终端提示文字
真正麻烦的从来不是更新动作本身
更新或回滚后最常出问题的地方，往往不在命令执行环节，而在后续行为变化：
- v3 首次运行
composer install可能报The lock file does not contain require-dev information，需删掉composer.lock重建 - 某些插件只兼容 v1.x，升级到 v2.x 后
Plugin installation failed却不报具体原因 -
platform配置里声明的 PHP 版本低于新 Composer 最低要求（如 v3 需 PHP 8.0+），composer install直接终止 - 多个 Composer 共存（Homebrew + 手动安装），
which composer和composer --version显示不一致，你以为更新了，其实没生效
更新前先看 composer --version 和 composer.lock 文件头里的生成版本，比盲目执行命令更重要。
