最可靠的全局镜像配置命令是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，其他写法易因键名错误、路径不匹配、url缺尾斜杠、项目级配置覆盖或缓存未清等原因静默失效。
全局镜像配置只有一条命令真正可靠：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。其他写法、路径、参数稍有偏差，就会静默失效——命令跑完没报错，但composer install仍卡在Downloading https://packagist.org/packages.json。
为什么composer config -g repo.packagist输出为空
不是命令失败，是配置根本没被 Composer 识别。常见原因包括：
- 键名写错：用了
repos.packagist（多一个 s）、mirror或repositories，Composer 完全忽略该字段 - 之前执行过
composer config -g repos.packagist，它把配置写进了无效位置，得先清理：composer config -g --unset repos.packagist - Composer ≥2.2 推荐用新键名
repositories.packagist.org，但旧命令不会自动覆盖它，必须手动--unset再设 - Windows 下 Git Bash 和 CMD/PowerShell 的
%APPDATA%路径不互通，改完记得重开终端再验证
URL末尾缺/会导致 404
Composer 会把 URL 和路径硬拼在一起，比如你配成https://mirrors.aliyun.com/composer（无尾斜杠），它实际请求的是https://mirrors.aliyun.com/composerpackages.json，直接 404。这不是网络问题，是路径拼接错误。
- 所有国内主流镜像都要求 URL 以
/结尾：https://mirrors.aliyun.com/composer/、https://mirrors.cloud.tencent.com/composer/ - 华为云地址
https://mirrors.huaweicloud.com/repository/php/末尾带/才有效；不带会 fallback 到官方源 - 千万别用已停用的
https://packagist.phpcomposer.com，Composer ≥2.2 会直接拒绝
项目级配置会彻底屏蔽全局设置
只要项目根目录的composer.json里有"repositories"字段，无论内容是否为空、是否含镜像，全局repo.packagist都会被跳过——这是设计行为，不是 bug。
- 进项目后先运行
composer config repo.packagist（不带-g），看是否有输出；有则说明项目自己写了源 - 想保留私有仓库又加镜像？别手写 JSON，用命令安全合并：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果
composer.json里"repositories"是数组（如已有私有包），命令会失败，需先手动转成对象："repositories": {} - CI/CD 环境下注意用户身份：用
sudo composer config -g写的是 root 的配置，但构建通常用run用户，读不到
验证是否真走镜像，别信“命令跑完了”
下载快 ≠ 走了镜像。Composer 元数据可能走镜像，但 zip 包仍从 GitHub 拉（尤其当项目里硬写了dist.url）。
- 最可靠方法：
composer update -vvv，搜日志里的GET行，确认域名是mirrors.aliyun.com或你配的镜像地址 - 检查
composer diagnose输出中Repo packagist.org:后面的地址，如果不是你设的镜像，说明没生效 - 执行
composer clear-cache，否则旧缓存的packages.json仍会干扰版本匹配 - 某些 Laravel 脚手架模板自带硬编码源，
create-project第一次就会卡住，这时得加参数：composer create-project laravel/laravel demo --repository-url=https://mirrors.aliyun.com/composer/
