composer换源不生效主因是键名错（应为repo.packagist而非repos.packagist）、漏写type值“composer”、url缺末尾斜杠，三者任一出错均静默失效；验证须查配置、diagnose及-vvv日志。
Composer 换源不生效，90% 是因为命令写错、版本不匹配或缓存没清——不是网络差，是根本没切过去。
composer config -g repo.packagist 为什么没输出？
这条命令看似执行成功，但 composer config -g repo.packagist 返回空或 null，说明配置根本没写进有效字段。常见原因：
-
repos.packagist（多了一个s）：Composer 内部只认单数repo.packagist，写成复数会静默存到无效 key - 漏掉
composer类型参数：完整命令必须是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，中间的composer是type值，不是注释 - Windows 下实际读的是
%APPDATA%\Composer\config.json，不是~/.composer/config.json，在 Git Bash 里改完，却用 CMD 验证，路径对不上
Composer 2.2+ 必须用 repositories.packagist.org
如果你用的是 composer --version ≥ 2.2（当前主流版本），repo.packagist 已被逐步弃用，部分环境会静默忽略。正确做法是：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 设阿里云：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}' - 设腾讯云：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}' - 验证是否生效：
composer config -g repositories.packagist.org应输出完整 JSON，不是空或报错 - 注意：value 必须是合法 JSON 字符串，单引号包裹整个值，内部双引号保留；URL 末尾
/缺一不可，否则报Invalid repository type
国内常用镜像地址（HTTPS + 末尾 / 缺一不可）
所有地址必须以 https:// 开头、结尾带 /，否则 Composer 2.5+ 会拼出错误路径（如 /composerpackages.json），直接 404。
- 阿里云：
https://mirrors.aliyun.com/composer/ - 腾讯云：
https://mirrors.cloud.tencent.com/composer/（默认 fallback 到官方源，CI 更稳） - 华为云：
https://mirrors.huaweicloud.com/repository/php/ - 中科大：
https://mirrors.ustc.edu.cn/composer/ - SJTUG（上海交大）：
https://packagist.mirrors.sjtug.sjtu.edu.cn/（教育网友好）
换源后 install 还卡在 packagist.org？
元数据（packages.json）可能走了镜像，但 dist 包（zip/tar）仍从 GitHub 或官方源下，导致超时。关键动作：
- 必须执行：
composer clear-cache，否则本地索引仍指向旧地址 - 验证真实请求：
composer update -vvv，盯住日志里Downloading的 URL，确认是镜像域名（如mirrors.aliyun.com） - 检查项目
composer.json是否有"dist-url"字段——它会强制覆盖镜像的 dist 映射，删掉再试 - 项目级
repositories字段优先级高于全局，哪怕只写了"repositories": {}，也会让全局配置失效
最易被忽略的是：URL 少一个 /、type 漏写、缓存没清——三者任意一个出错，都表现为“命令执行了，但没用”。
