PharException报错是composer.phar不完整或签名校验失败，必须重装不可修复；需先用ls -l和file命令确认损坏，再通过官方脚本下载、SHA-384校验、安装全流程操作，Windows用户应直接使用Composer-Setup.exe安装器。
PharException 报错不是文件“损坏”，而是 composer.phar 本身不完整或签名校验失败——必须重装，不能修复。
确认 composer.phar 确实损坏
运行 ls -l $(which composer)，如果输出 “cannot open” 或权限为 ----------，基本可判定文件不可读；再用 file $(which composer) 查看类型，若显示 data 而非 PHP script, ASCII text，说明文件被截断或写入异常。别信“修一下就行”，PHP 的 Phar 加载器在签名不匹配时会直接拒绝解析，这是安全机制，不是 bug。
Linux/macOS 下一步到位重装（带 SHA-384 校验）
官方安装脚本自带校验逻辑，跳过等于重蹈覆辙。按顺序执行：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 删旧文件：
sudo rm -f $(which composer)（路径以which composer输出为准） - 下载安装器：
php -r "copy('https://getcomposer.org/installer', '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 用户别碰命令行手动装
PowerShell 下用 Invoke-WebRequest 或浏览器下载 composer.phar，极易因换行符、杀毒软件拦截（如 Windows Defender）、UAC 权限导致文件不完整。成功率极低，且后续问题更难排查。直接去官网下载 Composer-Setup.exe（截至 2026 年 5 月仍有效），双击运行即可自动注册 PATH、关联文件类型，并绕过所有 PHAR 权限陷阱。
为什么不能用 php -d phar.readonly=0 强开
新版 PHP（≥ 8.1）已默认禁用该 INI 项，强行设置会报错；即使旧版能绕过，加载签名失效的 Phar 文件可能导致后续命令静默失败（比如 composer install 看似成功，但 vendor 中某些包实际未解压）。这不是“临时方案”，是引入不可控风险。
真正麻烦的点不在重装步骤，而在于：很多人重装后仍报错，其实是 PATH 没刷新、旧 alias 还在生效、或系统里存在多个 composer（比如 Homebrew 装了一个，手动又装了一个），冲突比损坏本身更难察觉。
