composer 2.2+ 已彻底移除 self-update 命令，执行报“command not defined”是因命令本身被删除，非网络、权限或拼写问题；必须通过官方脚本重装并校验 sha384 哈希。
composer self-update 报 “Command not defined” 是因为命令已被移除
不是网络卡、不是权限错、也不是拼写问题——self-update 这个命令从 Composer v2.2 起就被官方彻底删除了，到 v2.5.0 后连残留逻辑都没留。你现在执行 composer self-update，返回 Command "self-update" is not defined，说明你用的是 2.2+ 版本，它压根不认这个指令。
别再试 --snapshot、--1 或改 COMPOSER_HOME，这些对缺失的命令无效。真正要做的，是确认当前版本、找到正在运行的 composer.phar 文件位置，然后手动替换。
怎么确认正在用的 composer.phar 在哪
运行 which composer 只是查 shell 找到的第一个命令，它可能是 symlink、wrapper 脚本，甚至 alias。必须进一步验证：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 执行
ls -l $(which composer)，看输出是不是指向某个.phar文件（比如/home/user/bin/composer），还是指向/usr/local/bin/composer这类系统路径 - 如果是 symlink，用
readlink -f $(which composer)查真实路径 - 如果输出是
alias composer=...，就先运行unalias composer再重试 - Windows 用户用
where composer，注意结果可能是C:\ProgramData\ComposerSetup\bin\composer.bat—— 那你要替换的是同目录下的composer.phar，不是 .bat 文件
下载与校验 composer.phar 的安全操作
跳过校验等于把执行权交给中间链路，风险极高。GitHub Releases 页面每个 composer.phar 都附带 SHA384 哈希值，必须比对一致才能用：
- Linux/macOS：用
curl -o composer.phar https://github.com/composer/composer/releases/download/2.9.6/composer.phar（替换成最新 release tag） - Windows：用 PowerShell 执行
(Invoke-WebRequest -Uri "https://github.com/composer/composer/releases/download/2.9.6/composer.phar" -OutFile "composer.phar")，别用浏览器“另存为”，某些浏览器会加 .zip 后缀 - 校验命令必须是
shasum -a 384 composer.phar（不是 256），输出要和 GitHub 页面下方的哈希值**逐字符一致** - PowerShell 用户：用
Get-FileHash composer.phar -Algorithm SHA384 | Format-List，比对Hash字段 - 校验失败？删掉重下，别改后缀、别解压、别加
--no-sigcheck
替换后仍报错 SSL 或 “PharError” 怎么办
替换成功 ≠ 立刻可用。两个高频隐藏坑点：
-
php.ini中phar.readonly = Off必须启用，否则执行composer --version会报PharError；检查方式：php -i | grep phar.readonly - 国内环境常因 CA 证书缺失导致
composer diagnose报 SSL 错误，临时解决可设export COMPOSER_CAFILE=/etc/ssl/certs/ca-bundle.crt（路径按实际调整），但更稳的是配置国内镜像源：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - PHP CLI 缺
openssl扩展也会卡在 HTTPS 请求环节：运行php -m | grep openssl，无输出就得装扩展或换 PHP 版本（Composer 2.9.6 要求 PHP ≥ 8.0） - 替换后运行
composer --version输出仍是旧版？说明你覆盖的不是实际加载的那个文件，回退上一步重新确认路径
最麻烦的不是下载，而是路径判断和权限闭环——哪个目录可写、哪个 php.ini 生效、哪个 openssl 模块被加载，三者缺一不可。
