Composer安装失败90%是PHP环境不匹配，需确认CLI实际PHP版本≥7.2.5、curl/json/openssl/phar/zlib扩展全启用、阿里云镜像已配置且缓存已清，并排除sudo导致的属主污染。
Composer安装失败，90%不是网络或权限问题，而是PHP环境没配对——它不报错，只静默退出或返回Exit Code 1或Exit Code 255。
php -v显示8.2但composer还是报错？确认CLI实际用的是哪个PHP
很多人只运行php -v看到“8.2”就以为过关，但终端里跑的PHP和浏览器里跑的可能根本不是同一个二进制，更别说它们加载的php.ini了。Composer安装器全程走CLI，必须确认它调用的PHP版本和扩展真实可用。
- 运行
which php看路径，比如/usr/local/bin/php或/opt/homebrew/bin/php，别信系统默认软链 - 运行
php --ini，重点看Loaded Configuration File那一行，确保你改的php.ini真被读进去了 - Mac上用Homebrew装PHP，常漏装
php@8.2-curl这类子包，得单独brew install php@8.2-curl - Windows用户用XAMPP/MAMP，CLI的
php.ini通常在php\phpX.X.X\目录下，不是Apache那个
报错含“curl_init”“openssl_encrypt”或“json_encode”未定义？缺扩展不提示
Composer安装器启动前会严格检查curl、json、openssl、phar、zlib五个扩展是否已加载，缺一个就直接中断，且不告诉你缺谁。错误现象通常是PHP Fatal error: Uncaught Error: Call to undefined function curl_init()这类。
- 运行
php -m | grep -E "(curl|json|openssl|phar|zlib)"，五项必须全在输出里 - 缺
curl？Linux上可能是php-curl包没装；macOS用Homebrew需补装对应子包；Windows要确认php.ini里extension=php_curl.dll没被注释 - 缺
openssl还可能引发cURL error 60或证书校验失败，不只是功能缺失 - 别忽略
mbstring——某些包（如Laravel）依赖它，报mb_strlen未定义时，不是Composer问题，是扩展没开
下载卡住、Connection refused、file could not be downloaded？先切镜像再清缓存
国内用户直连packagist.org基本不可用，错误里带Connection refused、failed to open stream或长时间无响应，90%是源没切对，而不是你本地网络断了。
- 先确认是否真用了阿里云镜像：
composer config -g repo.packagist，输出必须是https://mirrors.aliyun.com/composer/（注意是https，HTTP已停用） - 换源后必须执行
composer clear-cache，否则旧缓存仍会尝试走原地址 - 临时验证是否生效：
composer install -vvv --no-progress，看日志里请求域名是不是mirrors.aliyun.com - 如果仍卡在下载，可临时关HTTPS校验（仅调试）：
composer config -g secure-http false，但生产环境禁用
Permission denied写入vendor或~/.composer/cache？大概率是误用sudo污染了归属
Permission denied报错95%不是权限不够，而是文件属主是root，而你正以普通用户运行命令。常见于不小心加了sudo composer install或sudo composer global require。
- 查
vendor/归属：ls -ld vendor/，若第一列是drwxr-xr-x 3 root root，说明已被污染 - 修复命令：
sudo chown -R $USER:$USER vendor/（Linux/macOS），顺手也检查composer.json和composer.lock所在目录 - 全局缓存出问题？运行
composer config --global cache-dir拿到路径，再ls -ld看归属，不对就sudo chown -R $USER:$USER $(composer config --global cache-dir) - WSL用户特别注意：项目放在
/mnt/c/下时，NTFS不支持Linux权限模型，chmod无效，唯一稳解是把项目移到~/projects/等WSL原生路径
最易被忽略的点是：PHP CLI配置与Web服务器配置不一致，以及sudo导致的归属污染——这两项不排查清楚，重装Composer毫无意义。
