composer config -g repo.packagist 命令必须显式指定 type 值为 composer，缺省则静默回退官方源；键名只能是 repo.packagist（单数），URL 必须 HTTPS 且末尾带 /，三者缺一不可。
composer config -g repo.packagist 命令必须带 type 参数
不加 composer 这个 type 值，命令就白执行了。比如写成 composer config -g repo.packagist https://mirrors.aliyun.com/composer/，表面上没报错，但 Composer 2.x 会直接 fallback 到 packagist.org，根本不会走镜像。
正确写法是中间明确写出 composer（这是仓库类型标识，不是随便写的字符串）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
-
repo.packagist是固定键名，不能写成repos.packagist或repositories - URL 必须以
/结尾，少一个斜杠就会拼出/composerpackages.json导致 404 - Windows 用户改完要重开终端，否则
composer config -g repo.packagist查不到新值
为什么 composer config -g repos.packagist false 不够用
只禁用默认源但不指定新源，Composer 会找不到包。常见错误是执行了 composer config -g repos.packagist false 就以为搞定了，结果 composer install 报 Could not find package xxx。
必须两步一起做：先关默认源，再加镜像源；或者一步到位用 repo.packagist 写法（它隐含了禁用 + 替换）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 推荐一步到位：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 若已误配，先清理：
composer config -g --unset repos.packagist，再重设 - 别混用
repos.*和repo.*，它们互不兼容，同时存在时后者优先但容易冲突
验证是否真生效，别信“命令跑完了”
运行 composer config -g repo.packagist 有输出 ≠ 真走镜像。有些情况配置写进去了，但缓存没清、日志没看，实际还在连 packagist.org。
- 清缓存：
composer clear-cache，否则旧packages.json会干扰版本解析 - 查诊断：
composer diagnose，看Repo packagist.org:后面是不是你设的镜像地址 - 看真实请求：
composer update -vvv 2>&1 | grep "GET https"，确认域名是mirrors.aliyun.com而不是packagist.org
项目级 repositories 配置的隐藏风险
在 composer.json 里写 "repositories" 数组，只影响该目录下执行的 composer install，对 composer create-project、全局插件安装、甚至某些 require-dev 包加载都无效。
更麻烦的是：它会覆盖全局配置，且顺序一错就 fallback 回官方源。比如这样写就危险：
{"repositories": [{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}]}
正确结构必须显式禁用默认源，并放第一位：
{"repositories": [{"packagist.org": false}, {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}]}
- 项目级配置无法解决“首次运行
composer就卡住”的问题 - 多人协作时，硬编码在
composer.json里的镜像地址容易被提交到 Git，暴露内部策略或引发冲突 - 真正干净的做法是：全局用
composer config -g repo.packagist，项目里只留业务相关配置
