composer config -g repo.packagist 命令没生效是因为三个硬性条件未满足：键名必须为单数 repo.packagist、type 值必须显式指定为 composer、url 必须 https 且末尾带 /；任一缺失均静默回退官方源，验证需输出完整 json 对象。
composer config -g repo.packagist 命令为什么没生效
根本不是网络慢或镜像站挂了，而是命令压根没写进配置文件——缺一不可的三个硬性条件没满足：repo.packagist（单数，不能写成 repos.packagist 或 repositories.packagist）、composer（type 值，必须显式写出）、URL 必须是 HTTPS 且末尾带斜杠（如 https://mirrors.aliyun.com/composer/✅，少斜杠就 404）。
验证是否真写进去了，别信终端没报错：
运行 composer config -g repo.packagist，正确输出应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象；如果返回空、null、或提示 Key "repo.packagist" does not exist，说明失败。
- Windows 下 CMD 对双引号解析异常，命令里别加引号：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（直接粘贴执行） - 权限不足时会静默失败，尤其用管理员 CMD 运行普通用户命令，或反之；建议用当前登录用户身份执行
- 若提示
Could not write to …，加--no-plugins重试：composer config -g --no-plugins repo.packagist composer https://mirrors.aliyun.com/composer/
项目级配置比全局更可靠的实际原因
全局配置写在 %APPDATA%\Composer\config.json，但它只对“以当前用户身份运行”的 Composer 有效。宝塔后台默认用 www 用户、CI 脚本常跑在 runner 用户下、Docker 容器里甚至没有 %APPDATA% 目录——你配的镜像它根本读不到。
项目级配置写入当前项目的 composer.json，天然可提交 Git，所有环境行为一致。命令是：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意没 -g）。
- 如果项目已有
"repositories": []（数组），该命令会报错；需先手动改成"repositories": {}（空对象）再运行 - 它只追加
"packagist"子项，不会覆盖已有的私有源（前提是原repositories是对象） - 切忌手写
"packagist.org": false——这会彻底关掉回退机制，镜像临时挂了就直接失败
换镜像后仍卡在 “Loading composer repositories” 怎么排查
这不是配置无效，而是请求根本没发到镜像站。大概率是项目级 repositories 字段覆盖了全局设置，或者 composer.json 里写了禁用语句。
分两步查清源头：
① 运行 composer config -g repo.packagist 看全局是否设置；
② 进入项目根目录，运行 composer config repo.packagist（去掉 -g），看是否被覆盖。
- 如果第②步返回空或官方地址，说明项目级
composer.json中的repositories字段完全屏蔽了全局配置 - 打开
composer.json，检查是否存在"packagist.org": false或整个"repositories"数组；有就删掉或注释掉 - 镜像只加速元数据（
composer.json描述）下载，不解决 ZIP 解压、PHP 扩展编译、autoload 生成等本地耗时环节
php -v 都报错，别急着装 Composer
Composer 是 PHP 工具，不是独立程序。没 php.exe，它连启动都做不到。
先在 CMD 或 PowerShell 里运行 php -v：
→ 如果提示“不是内部或外部命令”，说明 php.exe 所在目录（比如 C:\php 或 C:\xampp\php）没加进系统 Path 环境变量；
→ 如果能输出版本但带警告（如 Unable to load dynamic library 'php_openssl.dll'），要打开 php.ini，确认这三行已取消注释：extension=php_openssl.dllextension=php_curl.dllextension=php_zlib.dll
- XAMPP/WAMP 用户可先点控制面板里的“Shell”按钮临时加载环境变量，但长期使用仍需配系统 Path
- 改完环境变量后，必须关闭所有已打开的终端（CMD/PowerShell/VS Code 内置终端），再新开一个——旧进程不会读新 Path
- Composer-Setup.exe 安装后，去「系统属性 → 高级 → 环境变量」确认
C:\ProgramData\ComposerSetup\bin是否真在 Path 里；没找到就得手动加
composer.json 和全局配置之间那层隐性的优先级规则——这些地方出问题，连报错都不会给你，只会安静地走回官方源。
