Composer镜像配置不生效根本不是源的问题，而是命令写错一个字符就静默失败：键名必须为单数repo.packagist、type值composer不可省略、URL须HTTPS且末尾带/、必须加-g，缺一即回退官方源。
composer config -g repo.packagist 为什么总不生效
根本不是镜像源不行，是命令写错一个字符就静默失效，且完全不报错。你执行完 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后，必须立刻验证：composer config -g repo.packagist 输出得是完整 JSON 对象，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。输出为空、null 或仍显示 https://packagist.org，说明配置根本没写进去。
常见静默失败原因：
-
repo.packagist写成repos.packagist（多一个 s）或packagist.org—— 键名必须严格为单数repo.packagist - 漏掉中间的
composer—— 它是type值，不是可选参数；写成composer config -g repo.packagist https://...就 fallback 回官方源 - URL 少了末尾斜杠
/—— 拼出https://mirrors.aliyun.com/composer/packages.json导致 404 - 用
root用户执行了配置，但宝塔、CI 脚本或 IDE 是以www或runner用户运行，读的是各自家目录下的~/.composer/config.json
PHP 5.6 项目必须用 Composer 1.x + platform 伪装
Composer 2.x 不支持 PHP 5.6，装都装不上。强行用默认一键脚本安装，得到的是 v2，直接报错。旧项目维护必须回退到 Composer 1.x 最后稳定版（如 1.10.22）。
实操步骤：
立即学习“PHP免费学习笔记（深入）”；
- 下载指定版本：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"，再运行php composer-setup.php --version=1.10.22 - 确认版本：
php composer.phar --version应输出Composer version 1.10.22 - 在
composer.json顶层加"config": {"platform": {"php": "5.6.40"}}—— 注意必须带补丁号，"php": "5.6"无效 - 改完后跑
composer update --lock，否则composer install仍按旧composer.lock解析
别长期用 --ignore-platform-reqs，它绕过所有检查，可能装进不兼容的扩展（比如依赖 ext-mbstring 但系统没开）。
项目级配置比全局更可靠，尤其对 CI 和团队协作
全局配置在 GitHub Actions、宝塔、Docker 容器里基本不可靠——它们用的不是你的用户配置文件。项目级配置写进 composer.json，提交即生效，新人拉代码就能用。
正确写法（进项目根目录执行）：
-
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：没有-g） - 该命令会自动在
composer.json的"repositories"字段安全追加，不覆盖已有私有源 - 如果原来
"repositories": {}是空对象，命令会转为标准数组格式并插入 - 手动编辑时务必确保 JSON 合法：逗号位置正确、引号闭合、末尾不加多余逗号
改完建议删掉 vendor/ 和 composer.lock，再跑 composer install，强制从新源重新解析和下载。
换源后仍卡在 Resolving dependencies？和镜像无关
镜像只加速元数据加载和 ZIP 包下载，不参与依赖解析。卡在这一步几十秒甚至几分钟，99% 是环境或约束问题。
优先排查这几项：
-
config.platform.php和实际 PHP 版本不匹配 —— 比如锁了"php": "7.4"却在 PHP 8.5.5 上运行，触发大量降级查找 -
require-dev里塞太多工具链（phpunit、phpstan、friendsofphp/php-cs-fixer），大幅膨胀解空间 - Xdebug 开着 —— 解析慢 5–10 倍，临时禁用：
php -d xdebug.mode=off $(which composer) update - 内存不足 —— 默认 128M 不够，设
COMPOSER_MEMORY_LIMIT=-1再试 - 用了已废弃的
fxp/composer-asset-plugin—— 它绕过 Composer 镜像机制，直连 Bower/NPM 源，国内无法加速
这些点不解决，换任何镜像都没用。真正耗时的从来不是下载，而是 Composer 在本地穷举满足所有约束的包版本组合。
