composer全局镜像配置失效的主因是参数错误与版本适配问题：repo.packagist必须单数小写、显式指定type为composer、url末尾带/；composer 2.2+需改用repositories.packagist.org键名并传json值；且必须执行composer clear-cache清除缓存。
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 这条命令就能改掉默认源，但90%的人执行后没生效，不是网络问题，而是漏了关键细节。
为什么 composer config -g repo.packagist 总不生效
它不是“运行了就完事”，而是对参数极其敏感的写入操作，错一个就静默回退到 https://packagist.org，且完全不报错。
-
repo.packagist必须是单数、全小写、不能多一个s（repos.packagist是无效字段） - 必须显式写出
composer作为 type 值——这不是注释，省略它等于没配 - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会拼成/composerpackages.json导致 404） - 没加
-g参数 → 只改当前项目，换目录就失效 - 执行后没跑
composer clear-cache→ 本地缓存仍指向旧源，一切白配
Composer 2.2+ 用户该用 repositories.packagist.org
如果你的 composer --version 是 2.2 或更高，repo.packagist 可能被静默忽略。直接用新版键名：
- 设阿里云：
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 --unset repositories.packagist.org
注意：value 必须是合法 JSON 字符串，用单引号包裹整个值，内部双引号保留；URL 末尾 / 缺一不可，否则报 Invalid repository type。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
项目级配置比全局更可靠
全局配置在 CI、宝塔、多项目混用时极易出问题——比如某个项目 composer.json 里写了 "repositories": []，就会彻底屏蔽全局设置，连镜像都拉不到。
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 它会安全合并进
composer.json的repositories字段，key 固定为"packagist" - 前提：原
repositories是对象（如"repositories": {}），不是数组；如果是数组，命令会失败，需先手动转成对象 - Git 提交后，队友
git pull && composer install自动走镜像，composer.lockhash 一致
验证是否真生效了
不能只信命令回显“成功”，得看三处输出是否一致：
- 查配置：
composer config -g repo.packagist或composer config -g repositories.packagist.org，输出必须是镜像地址，不是空或https://packagist.org - 看诊断：
composer diagnose，找到 “Repo:” 那一行，域名必须匹配你设的镜像 - 抓真实请求：
composer update -vvv，日志里Downloading的 URL 应含mirrors.aliyun.com
最易被忽略的是缓存和版本键名匹配——哪怕命令全对，composer clear-cache 没跑，或者 Composer ≥2.2 却还在用 repo.packagist，结果都一样：卡在 Downloading，以为网络差，其实根本没走镜像。
