执行 composer config -g repo.packagist 无反应或未生效，通常因键名错误、type 值缺失或 URL 格式不合规；应确保键名为 repo.packagist（单数）、type 显式为 composer、URL 为 HTTPS 且末尾带 /，并验证输出为完整 JSON 对象。
composer config -g repo.packagist 为什么总没反应
命令执行后无报错、composer install照常卡在 Loading composer repositories，大概率是三个硬性条件漏掉一个：键名必须是 repo.packagist（单数，不能写成 repos.packagist 或 packagist.org），第二个参数必须显式写 composer（这是 type 值，不是可选或默认项），URL 必须是 HTTPS 且末尾带 /（例如 https://mirrors.aliyun.com/composer/✅，少斜杠会拼出 /composerpackages.json 导致 404）。
验证是否真写进去了，只看这一条命令：composer config -g repo.packagist。输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报 Key not found，说明根本没写进去——别猜网络或权限，先重试命令，盯紧那三个字段。
项目级配置比全局更可靠，尤其在协作和 CI 场景
全局配置只对当前 shell 用户生效，CI 流水线（GitHub Actions、GitLab Runner）、宝塔后台（以 www 用户运行）、Docker 容器里都读不到你的 ~/.composer/config.json。项目级配置写进 composer.json 的 repositories 字段，Git 可跟踪，行为一致。
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加-g） - 它会自动追加或生成
"repositories": {"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}，不破坏已有私有源 - 改完必须删掉
vendor/和composer.lock，再跑composer install；用update会沿用旧 lock 文件里的海外地址 - 如果项目
composer.json里已有"packagist.org": false这类禁用语句，手动加镜像字段也无效——得改成"packagist": {"type": "composer", "url": "..."}
换源后还卡在 Resolving dependencies？镜像不背这个锅
镜像只加速元数据拉取和 ZIP 包下载，解决不了依赖解析阶段的性能问题。如果你发现 composer install 卡在 Resolving dependencies 或 Checking the stability of the installed packages，和镜像源完全无关。
常见真实原因包括：
-
"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"这类过宽的 PHP 版本约束，让 Composer 尝试数百种组合 -
require-dev里堆了太多工具：比如phpunit/phpunit+phpstan/phpstan+psalm/phar+friendsofphp/php-cs-fixer，版本冲突概率飙升 - 老项目用了已废弃的
fxp/composer-asset-plugin，它绕过 Composer 镜像机制，直连 Bower/NPM，而这俩源国内基本不可用 - 本地
~/.composer/cache损坏，可试composer clear-cache后重试
多镜像混用或临时切源时的坑
不要在同一个环境里混配多个镜像（比如全局设阿里云，项目里又设清华源），容易触发 Repository has no URL defined 错误。优先级规则简单：项目级 repositories > 全局 repo.packagist，但两者结构不兼容时会静默失效。
临时测试不同镜像（比如 CI 中对比稳定性），推荐用 --repository-url 参数：
composer create-project laravel/laravel myapp --repository-url=https://mirrors.tuna.tsinghua.edu.cn/composer/composer update --repository-url=https://mirrors.huaweicloud.com/repository/php/
这种用法不写入任何配置文件，执行完即失效，避免污染环境。注意华为云地址末尾不带 /，但 --repository-url 会自动补全，不影响使用。
