composer config -g repo.packagist 必须严格满足三要素才生效：键名必须为 repo.packagist（一字不差）、type 值为小写 composer（不可省略）、url 必须是 https 且末尾带 /；缺一即退回到官方源，且项目级 repositories 会完全屏蔽全局配置。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 即可生效，但漏掉 -g、写错键名 repo.packagist、或 URL 少末尾 /，都会静默失效——你看到的“没变快”，其实是它根本没走镜像。
为什么 composer config -g repo.packagist 总是不生效
这条命令本身不报错，但 Composer 对字段名、参数顺序、URL 格式有硬性要求，三者缺一即退回到 https://packagist.org：
-
repo.packagist必须一字不差：写成repos.packagist、mirror或packagist.org全部无效 - 中间的
composer是type值，小写，不可省略——漏掉它，配置结构不合法，部分版本会直接丢弃 - URL 必须 HTTPS（内网可用 HTTP），且末尾必须带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼出/composerpackages.json导致 404） - 必须加
-g：不加就只改当前项目composer.json，换目录即失效
验证是否真走镜像源
别信“好像快了”或 composer config -g 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，输出必须是完整 JSON 对象，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；返回空、null或仍是官方地址，说明失败 - 运行
composer diagnose，看 “Repo packagist.org:” 后面是不是你配的镜像地址；若仍是https://packagist.org，说明被项目级repositories覆盖了 - 运行
composer install -vvv 2>&1 | grep "Downloading"，日志里出现的域名必须是你的镜像域名（如mirrors.aliyun.com）——这是最终确认
项目级 repositories 会完全屏蔽全局配置
Composer 的配置读取是硬编码覆盖链，不是优先级叠加。只要项目根目录下 composer.json 中存在 "repositories" 字段（哪怕只是空数组 "repositories": []），全局 repo.packagist 就彻底不被读取：
- 检查
composer.json是否含"repositories"键；CI/CD 流水线中常有人误加，导致本地快、线上慢 - 如果已有
"repositories": {}（对象），composer config repo.packagist会安全合并；但如果已是数组[{"type":"composer","url":""}]，该命令会直接报错或覆盖整个字段 - 删掉
repositories后，必须执行composer clear-cache，否则缓存里仍存着旧的官方源元数据，请求还会发往packagist.org
不同环境下的配置落盘位置和用户权限
全局配置写入的是当前用户的家目录，不是系统级路径。在宝塔、Jenkins、Docker 等环境中，容易因用户身份不一致导致配置“写了却没用”：
- Linux/macOS 实际路径是
~/.composer/config.json（即/home/xxx/.composer/config.json）；Windows 是%APPDATA%\Composer\config.json - 宝塔定时任务默认用
www用户执行，你用root配的配置它读不到；应改用sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Docker 构建时，
~/.composer默认不存在，RUN composer config -g必须显式执行；Alpine 镜像还需补证书：RUN apk add --no-cache ca-certificates - Windows 用户执行完建议关掉终端重开，否则 shell 可能仍读取旧环境变量或缓存的配置
最易被忽略的一点：缓存不是“包文件”，而是 packages.json 元数据。即使配置全对、路径也正确，只要缓存没清，composer update 仍会去请求 https://packagist.org/packages.json——卡住、慢、fallback，根源往往在这里。
