Composer config -g repo.packagist 没生效根本不是网络问题，而是命令写错：漏-g、键名多s（repos.packagist）、URL末尾缺/、或漏掉必需type值composer，任一出错即静默回退官方源；验证需输出完整JSON对象。
composer config -g repo.packagist 为什么没生效
根本不是网络慢，而是命令写错了——漏 -g、键名写成 repos.packagist（多了一个 s）、URL 少了末尾 /，或者中间漏掉 composer 这个 type 值，四者任一出错，Composer 都不报错，只默默 fallback 到 https://packagist.org。
验证方法很简单：运行 composer config -g repo.packagist，正确输出应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果为空、null 或结构不对，说明配置压根没被识别。
-
repo.packagist是固定键名，大小写敏感，不能加s，也不能写成Repo.Packagist -
composer是必需的 type 值，不是可选参数，也不是注释，漏掉就等于没配 - URL 必须以
https://开头，且末尾必须带/；写成https://mirrors.aliyun.com/composer会导致请求路径拼成/composerpackages.json，直接 404 - Windows 下若用 Git Bash，
COMPOSER_HOME可能未生效，实际读取的是%APPDATA%\Composer\config.json，而非~/.composer/config.json
项目级配置覆盖全局时怎么临时绕过
有些 Laravel 脚手架或私有模板的 composer.json 里硬编码了 "repositories" 字段（哪怕只是空数组），就会彻底屏蔽全局镜像配置——composer create-project 或插件加载阶段还没读到全局配置，就已经卡在官方源了。
检查当前项目是否自带仓库配置：grep -A5 repositories composer.json。如果存在，别急着删，先试试临时绕过：
- 清除项目级配置：
composer config --unset repositories（注意不加-g） - 显式重定向本次命令：
composer install --repository=https://mirrors.aliyun.com/composer/ - 初始化新项目时直接指定：
composer create-project laravel/laravel demo --repository-url=https://mirrors.aliyun.com/composer/
阿里云镜像地址选哪个？内网和公网要分开
公网开发机统一用 https://mirrors.aliyun.com/composer/；但如果你在阿里云 VPC 内网环境（比如 ECS 实例部署 CI 或私有 Packagist），必须换为内网地址：http://mirrors.cloud.aliyuncs.com/composer/。
这个内网地址实测延迟压到 10ms 内、零丢包，但本地开发机或非阿里云服务器访问会失败——它不走公网，也不支持 HTTPS，强行用 HTTPS 会直接连接超时。
- 内网地址只能用于阿里云同地域 VPC，跨地域或混合云需走公网镜像
- 内网地址用
http://，不是https://，写错协议会失败 - 切内网源后仍需执行
composer clear-cache，否则旧缓存可能残留公网元数据
切换后还要清缓存和重生成 lock 文件
就算镜像配置全对、composer config -g repo.packagist 输出也正常，composer install 仍可能卡在旧地址——因为 composer.lock 里硬编码了 dist.url，指向原始源；而 Composer 会优先尝试锁文件里的 URL，失败后才 fallback 到镜像。
所以完整切换流程必须包含这三步：
- 执行镜像配置命令（带
-g或不带，按需） - 运行
composer clear-cache清掉本地元数据缓存 - 删掉
vendor/和composer.lock，再跑composer install -vvv，观察日志中所有Downloading行是否都含mirrors.aliyun.com
尤其团队协作时，composer.lock 提交前没重生成，别人拉代码后 install 仍会连错源——这点最容易被跳过。
