composer安装失败主因是php缺curl/openssl/zip等扩展或path未配置；修复需验证扩展启用、将composer.phar移至/usr/local/bin并设权限，镜像配置须全局生效且同步清缓存删lock文件。
Composer安装失败常见原因与修复路径
安装失败基本就两类：PHP 环境缺失关键扩展，或执行权限/路径配置错乱。别急着重装，先看报错里有没有php-curl、php-openssl、php-zip这类关键词——它们是 Composer 运行的硬依赖。
Linux 下用php -m | grep -E "curl|openssl|zip"快速验证；Windows 用户打开php.ini确认这些扩展前面没分号。Ubuntu 系统可直接运行：sudo apt install php-cli php-mbstring php-zip php-curl php-xml补全。
如果提示command not found: composer，说明composer.phar没放进$PATH。别手动改环境变量，更稳妥的做法是：sudo mv composer.phar /usr/local/bin/composer，然后验证composer --version是否返回版本号。
- CI/CD 流水线中建议用脚本安装最新版：
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 宝塔面板或 Docker 构建时，务必确认执行用户（如
www或runner）有权限读写~/.composer目录，否则config -g写的配置根本不会被加载 - Windows 安装包方式若提示“PHP path not found”，不要手动填路径，重启安装程序并勾选“Add to PATH”——它会自动探测已安装的 PHP
镜像配置为什么总不生效？三处必须对齐
镜像配置静默失效，不是镜像挂了，是你写的配置根本没被 Composer 读到。必须同时满足三处一致，才算真正启用：
- 运行
composer config -g repo.packagist，输出必须是完整 JSON，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或报错，说明全局配置没落盘 - 运行
composer config repo.packagist（无-g），确认项目级是否覆盖了全局设置；只要项目根目录composer.json里存在"repositories"字段（哪怕只是"repositories": []），全局配置就完全失效 - 执行
composer diagnose，重点看最后一行是否显示Repo packagist is private；再跑composer show packagist/support，检查homepage字段 URL 是否含镜像域名（如mirrors.aliyun.com）
常见手误：repos.packagist（多一个s）、漏掉composer这个type值、URL 少末尾斜杠/、用http://而非https://（会被secure-http=true拦截）。
华为云/阿里云/腾讯云镜像地址与参数细节
2026 年实测可用地址和关键参数差异如下，错一个字符就会 fallback 到官方源：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 华为云唯一稳定地址：
https://repo.huaweicloud.com/repository/php/（注意末尾/，且路径含/repository/php/，旧地址如https://mirrors.huaweicloud.com/composer/已 404） - 阿里云推荐地址：
https://mirrors.aliyun.com/composer/（同步频率 15 分钟，稳定性高） - 腾讯云地址：
https://mirrors.cloud.tencent.com/composer/（同步频率 30 分钟，适合深度集成腾讯云服务的项目）
配置命令必须带composer类型和-g参数：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。少composer或漏-g，就会写成项目级或无效字段。
换源后仍卡在Loading composer repositories？大概率是composer.json里写了"packagist.org": false但格式不对——它必须是repositories数组里的独立对象项，不能嵌套，也不能拼成"packagist": false。
换镜像后 vendor 和 lock 文件要不要删？
要删，而且必须一起删。Composer 的composer.lock文件里存的是每个包的dist.url哈希和元数据来源地址。你换了镜像但没删lock，Composer 仍会按旧地址去拉取 zip 包，结果就是 404 或超时。
标准操作顺序是：
- 先运行
composer config -g repo.packagist composer https://xxx.com/composer/ - 再删掉
vendor/目录和composer.lock文件 - 最后执行
composer install
CI 脚本里建议加一行rm -rf vendor composer.lock，避免缓存导致行为不一致。另外，并发下载数默认只有 5，国内镜像节点多、延迟低，建议顺手调高：composer config -g parallel-downloads 15，实测能压满带宽，安装耗时下降 40%～60%。
最易被忽略的一点：镜像同步有延迟，packages.json更新快，但p2/vendor/name/version.json这类 provider 文件可能滞后几小时。如果卡在某个provider-*.json请求上，先curl -I对比镜像与官方源该文件是否存在，再决定是否临时切中科大源应急。
