直接重装 composer.phar：删除旧文件，用官方带 SHA-384 校验的 install.php 脚本重新安装，并确认 PHP ≥ 7.4 且 PATH 干净。
“PharException: phar” 报错不是文件“损坏”，而是 composer.phar 本身不完整或校验失败——直接重装，别修。
composer.phar 文件报 PharException 怎么办
这个错误通常出现在运行 composer 命令时，PHP 解析 composer.phar 失败，提示类似 PharException: phar "/usr/local/bin/composer" has a broken signature 或直接 Fatal error: Uncaught exception 'PharException'。它不是缓存问题，也不是 vendor 目录出错，而是二进制文件本身在下载、写入或权限处理过程中被截断或篡改。
- 别尝试用
php -d phar.readonly=0强开——这是治标不治本，且新版 PHP 已默认禁用该绕过 - 先确认是不是真有这个文件：
ls -l $(which composer)或file $(which composer)；如果显示 “cannot open” 或 “data” 而非 “PHP script, ASCII text” 就基本坐实损坏 - Windows 用户若用 .exe 安装器装的，极少出现此问题；该错误高发于手动
curl下载后没校验、或用php composer-setup.php却中途断电/中断
Linux/macOS 一步重装并验证 composer.phar
官方安装脚本自带 SHA-384 校验，必须走这步，跳过等于重蹈覆辙。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 清理旧文件：
sudo rm -f /usr/local/bin/composer（路径以which composer输出为准） - 下载并校验安装器：
php -r "copy('https://www.php.cn/link/57f5b6b5cd278f4b15f27a126e42a7b5installer', 'composer-setup.php');"，然后执行：HASH=$(curl -sS https://composer.github.io/installer.sig) && php -r "if (hash_file('sha384', 'composer-setup.php') === '\$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" - 安装：
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer - 删临时文件：
rm composer-setup.php - 验证：
composer --version应输出版本号；再跑composer diagnose看是否提示 “OK”
Windows 用户遇到 PharException 别折腾命令行
手动下载 composer.phar 或用 php composer-setup.php 在 Windows 上极易因换行符、杀毒软件拦截、UAC 权限导致文件不完整。
- 直接去 https://www.php.cn/link/57f5b6b5cd278f4b15f27a126e42a7b5 下载
Composer-Setup.exe（首页大按钮） - 双击运行，关键步骤：在 “PHP executable path” 页面务必填对你的
php.exe绝对路径（如C:\php\php.exe），不能留空 - 勾选
Add Composer to the system PATH；不勾 = 装了也白装 - 安装完重启终端（CMD/PowerShell），再运行
composer --version；如果仍报错，检查杀毒软件是否把刚生成的composer.bat或composer.phar隔离了
重装后还报错？重点查这三处
重装脚本成功不代表万事大吉。很多“重装后依旧失败”的案例，根源不在 composer.phar，而在环境链路断裂。
-
php -v输出的版本低于 7.4 —— Composer 2.5+ 已不再兼容 PHP 7.2/7.3，会静默加载失败，只报 Phar 错误 - 系统 PATH 里存在多个
composer：运行where composer（Windows）或type -a composer（macOS/Linux），删掉旧路径下的残留（比如~/bin/composer或 Homebrew 装的老版本） - 某些 IDE（如 PhpStorm）内置了嵌入式 Composer，并劫持了终端命令；关掉 IDE 再测试终端原生命令，避免误判
真正要命的不是文件损坏，是重装后没验证 php 版本和 PATH 干净度——这两点漏掉，重装十次也没用。
