composer.phar损坏无法修复，只能重装：先删除旧文件，再用官方带SHA-384校验的install.php脚本重新安装，并确认PHP≥7.4、phar扩展已启用且phar.readonly=Off。
composer.phar 损坏无法修复，只能重装——它不是文本文件，不能“修”，只能校验后替换。
PharException 报错说明文件已不可信
运行 composer 时抛出 PharException: phar "/usr/local/bin/composer" has a broken signature 或直接 Fatal error: Uncaught exception 'PharException'，这不是缓存或权限问题，而是 composer.phar 文件本身在下载、写入或校验环节被截断、篡改或不完整。PHP 解析器拒绝加载它，这是安全机制，不是 bug。
- 先确认是否真有该文件：
ls -l $(which composer)；若输出 “cannot open” 或file $(which composer)显示 “data” 而非 “PHP script, ASCII text”，基本坐实损坏 - 别用
php -d phar.readonly=0强开——新版 PHP 已默认禁用该绕过，且强行加载损坏文件可能导致后续命令静默失败 - Windows 用户若用 .exe 安装器安装，极少出现此问题；该错误高发于手动
curl下载后未校验、或php composer-setup.php中途断电/中断
一步重装并强制校验（Linux/macOS）
官方安装脚本自带 SHA-384 校验，跳过等于重蹈覆辙。必须走这步，不能省。
- 清理旧文件：
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 用户别折腾命令行
手动下载 composer.phar 或用 php composer-setup.php 在 Windows 上极易因换行符、杀毒软件拦截（如 Windows Defender / 火绒）、UAC 权限导致文件不完整，成功率极低。
- 直接去 https://www.php.cn/link/594ca739e3609243a6b6a3dd8d871114 下载最新
Composer-Setup.exe - 双击运行，它会自动注册 PATH、关联文件类型，并规避所有 PHAR 相关权限陷阱
- 若已安装但报错，可先卸载旧版，再运行新
.exe；不要尝试覆盖或手动替换composer.phar
phar 扩展和只读设置是前置依赖
即使重装成功，如果 PHP CLI 未启用 phar 扩展，或 phar.readonly = On，composer install 仍会在解包阶段失败，报类似 PharError: Cannot write to phar archive。
- 确认扩展已加载：
php -m | grep phar；若无输出，需在对应php.ini中取消注释extension=phar.so（Linux/macOS）或extension=php_phar.dll（Windows） - 确认写权限开启：
php -i | grep "phar.readonly"应返回Off；若为On，在php.ini中设phar.readonly = Off - 注意：CLI 和 Web 可能使用不同
php.ini，用php --ini查看 CLI 实际加载的配置路径 - 改完必须新开终端，否则配置不生效
最易被忽略的是：重装前没确认 PHP CLI 的真实配置路径，或重装后没验证 phar.readonly 是否真正关闭——这两点会导致你白忙一场，错误现象一模一样。
