必须带 composer 参数，因为 repo.packagist 的值需为含 type: "composer" 的完整仓库对象，否则被当作普通 HTTP 源而失效；字段名、URL 末尾斜杠、全局与项目级配置优先级均影响生效。
必须用 composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/ 这条命令，缺一不可——漏掉中间的 composer 类型标识、写错字段名（比如 repos.packagist）、URL 少末尾斜杠，都会静默失效。
为什么 composer config -g repo.packagist 必须带 composer 这个参数
这个命令不是简单设个 URL，而是定义一个仓库对象。Composer 要求 repo.packagist 的值是一个完整仓库配置，其中 type 字段必须显式为 composer，否则它会把地址当普通 HTTP 源处理，后续依赖解析仍 fallback 到官方源。
-
composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/✅ 正确：第二个参数composer就是type值 -
composer config -g repo.packagist https://mirrors.ustc.edu.cn/composer/❌ 错误：没指定 type，配置写入但无效 -
composer config -g repos.packagist composer https://mirrors.ustc.edu.cn/composer/❌ 错误：字段名多了一个s，不会报错，但根本不写入
执行后怎么确认 USTC 镜像真的生效了
别只跑 composer config -g 看一堆配置，要精准查字段：
- 运行
composer config -g repo.packagist，输出应为类似{"type": "composer", "url": "https://mirrors.ustc.edu.cn/composer/"} - 如果返回空、
null或https://packagist.org，说明没成功 - 常见原因：之前残留了
repos.packagist配置（带 s），得先清理：composer config -g --unset repos.packagist - 验证时别漏
-g，否则查的是当前项目配置，不是全局
项目里有 repositories 字段时 USTC 镜像会被忽略
只要项目根目录的 composer.json 里写了 repositories，无论内容是否合理，它都会无条件覆盖全局配置——这是 Composer 的硬编码优先级：项目 > 用户 > 全局。
- 例如模板项目自带
"repositories": [{"type": "composer", "url": "https://packagist.org"}]，一拉代码就让 USTC 镜像失效 - 检查是否被覆盖：运行
composer config repo.packagist（不加-g），若输出为空或报错，说明项目级配置接管了 - 临时绕过：加
--repository-url=https://mirrors.ustc.edu.cn/composer/参数，如composer install --repository-url=https://mirrors.ustc.edu.cn/composer/
USTC 镜像地址的细节和兼容性
截至 2026 年 7 月，https://mirrors.ustc.edu.cn/composer/ 是稳定可用的 HTTPS 地址，但要注意几个边界点：
- URL 必须以
/结尾，https://mirrors.ustc.edu.cn/composer（少斜杠）在部分 Composer 版本下返回 404 - 仅同步 public 包，私有包或
dev-main这类未打 tag 的分支不会镜像，此时会 fallback 失败 - 教育网、北方地区延迟最低，但新包同步有 ≤15 分钟窗口期；若刚发布就
require，可能暂时找不到 - 不支持 HTTP，Composer ≥2.2 默认拒绝非 HTTPS 源，别用旧教程里的
http://地址
最常被忽略的其实是项目级 repositories 的覆盖行为——你以为配好了全局镜像，结果团队模板里一行配置就让它形同虚设。验证时务必分清 composer config -g 和 composer config 的区别，否则永远不知道问题出在哪。
