Composer安装失败主因是PHP扩展缺失或镜像源配置不当；需确保CLI环境含mbstring、xml、zip、curl等扩展，用官方installer安装并配置阿里云带签名验证的镜像源。
直接装 composer 命令但报 Class not found 或卡在 Loading composer repositories，基本不是网络问题，而是 PHP 扩展缺失或镜像源没切对。阿里云镜像能解决 90% 的卡顿和超时，但必须配合正确的 PHP 环境一起生效。
确认 PHP CLI 环境是否完整
Composer 是 PHP 脚本，依赖 CLI 模式下的扩展。Ubuntu 22.04 默认只装了最简 php-cli，缺 mbstring、xml、zip、curl 会直接失败。
- 运行
php -v确认 PHP 版本（推荐 8.1+） - 检查关键扩展是否启用：
php -m | grep -E "^(mbstring|xml|zip|curl|openssl)$"，缺哪个就装哪个，例如：sudo apt install php-mbstring php-xml php-zip php-curl - 别跳过
php-opcache和php-cli—— 后者是执行入口，前者影响 Composer 自身加载速度
用官方 installer 安装 composer.phar 并设为全局命令
不推荐 sudo apt install composer，Ubuntu 仓库里仍是 2.2.x，不支持 PHP 8.3、Laravel 11、Symfony 7 等新项目依赖解析逻辑。
- 下载安装器：
curl -sS https://getcomposer.org/installer -o composer-setup.php - 校验 SHA384（官网每次发布都会更新，务必查 最新哈希值）：
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e40f197b752f13fd98ab1063c0031dad88e589d3179930483d78b39...') { 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 - 验证：
composer --version应输出类似Composer version 2.5.8
配置阿里云 Composer 镜像源（全局生效）
默认源 https://repo.packagist.org 在国内直连几乎必超时，阿里云镜像地址是 https://mirrors.aliyun.com/composer/，但不能简单替换 URL —— Composer 2.2+ 要求镜像源带签名验证，必须用 composer config 命令设置。
- 全局启用阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist，应返回完整对象，含"url": "https://mirrors.aliyun.com/composer/" - 如果项目里已有
composer.json，且里面写了"repositories"，全局配置会被覆盖 —— 此时需在项目根目录手动加：composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 注意：阿里云镜像不代理所有私有包，如遇到
Package not found，先确认该包是否开源、是否在 Packagist 上注册
常见卡点与绕过方式
即使镜像源和 PHP 环境都对了，仍可能卡在 Loading composer repositories —— 这往往不是源的问题，而是 Composer 自身缓存或 DNS 解析异常。
- 清空 Composer 缓存：
composer clear-cache - 临时禁用 HTTPS 验证（仅调试用，勿长期开启）：
export COMPOSER_NO_SSL=1，再运行composer install - 检查 DNS 是否污染：
dig mirrors.aliyun.com +short，若返回空或国外 IP，改用114.114.114.114或223.5.5.5 -
composer create-project卡住时，加--no-interaction --prefer-dist参数可跳过交互和源码克隆，强制走压缩包下载
真正耗时间的从来不是命令敲得快不快，而是 PHP 扩展有没有全、镜像源有没有签名校验、缓存有没有被旧版本污染。这三个点没对齐，换再快的镜像也白搭。
