composer镜像配置失效主因是命令错误：必须用单数键名repo.packagist、显式指定type值composer、url以https开头且末尾带/，三者缺一即静默回退官方源，且不报错。
composer config -g repo.packagist 命令为什么总不生效
不是网络卡，是命令写错了——漏 -g、键名写成 repos.packagist、URL 少了末尾 /，三者任一出错，Composer 都静默走 https://packagist.org，且完全不报错。
Composer 2.2+ 内部硬编码只认 repo.packagist（单数、全小写、无 s），写成 Repo.Packagist 或 packagist.org 会存进无效字段。验证是否成功，必须运行：
composer config -g repo.packagist
输出应为类似：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果返回 null、空对象或报错，说明配置失败。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
-g必须带上，否则只改当前项目composer.json，换目录就失效 -
composer是必需的type值，不是注释；漏掉它，Composer fallback 到官方源 - URL 必须 HTTPS 开头且以
/结尾，否则请求路径拼成/composerpackages.json直接 404
阿里云 / 腾讯云 / 华为云镜像地址格式差异
不同镜像 URL 路径结构不同，不能套用同一模板。华为云路径含 /repository/php/，阿里云和腾讯云是 /composer/，中科大是根路径。
- 阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 华为云：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/ - 中科大：
composer config -g repo.packagist composer https://packagist.mirrors.ustc.edu.cn/ - 清华旧镜像
https://packagist.phpcomposer.com已下线，继续用会报CURL error 60或Could not resolve host
换源后仍卡在 Downloading 或 Resolving dependencies 怎么办
现象是命令卡在 Downloading https://packagist.org/packages.json，说明镜像根本没走通——不是慢，是配置未命中。
- 先跑
composer diagnose，确认secure-http: OK和signature verification: OK；若后者为disabled，说明镜像跳过了签名校验，有安全风险 - 删掉
vendor/和composer.lock，再执行composer install --no-dev --no-scripts --no-autoloader；composer.lock是宕机时唯一保命文件，它不存在或损坏，换镜像也没用 - 执行
composer clear-cache—— 换源后不清理缓存，本地元数据仍指向旧源，一切白配 - 如果
composer config -g repo.packagist输出正常但依然连不上，检查~/.composer/config.json文件权限，常见于 CI 环境或宝塔面板中该文件被设为只读
全局配置 vs 项目级配置：什么时候该用哪个
全局配置看着省事，但在 CI 流水线、多项目混用、团队协作场景下极易出问题；项目级配置更可控，但需注意合并逻辑。
- 全局配置优先级高于项目配置，适合个人开发机；但一旦项目
composer.json中有"repositories": []或"packagist.org": false，会覆盖全局设置 - 项目级配置命令是去掉
-g：composer config repo.packagist composer https://mirrors.aliyun.com/composer/，它会向composer.json的repositories字段追加"packagist"条目，不覆盖已有私有源（前提是原repositories是对象而非数组） - 公司有私有仓库？建议禁用默认源：
composer config -g repos.packagist false，再单独加镜像：composer config -g repos.aliyun composer https://mirrors.aliyun.com/composer/ - 别直接编辑
composer.json手动加repositories—— 镜像地址随 Git 提交，泄露内部配置；且顺序敏感，排不到第一仍可能 fallback 到官方源
type 值缺失、URL 末尾斜杠。这三处任意一个出错，整个配置就形同虚设，而 Composer 不会提示你哪里错了。
