Composer全局镜像配置失效主因是缺-g、键名误写为repos.packagist（应为repo.packagist）、漏type:"composer"；验证需输出完整JSON，URL须HTTPS且结尾带/；切换后须执行composer clear-cache和composer update --lock刷新lock文件。
composer config -g repo.packagist 命令为什么总不生效
不是网络慢，是命令漏了关键三要素：缺 -g、键名写成 repos.packagist（多了一个 s）、或漏掉 composer 这个 type 值。任一出错，Composer 都会静默 fallback 到官方源，且完全不报错。
验证是否真生效，必须运行：composer config -g repo.packagist
输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果输出为空、null 或报错 No repositories configured，说明配置根本没写进去。
-
-g必须加，否则只改当前项目composer.json，换目录就失效 - 键名严格为
repo.packagist（单数、全小写、无s），Repo.Packagist或repos.packagist都无效 -
composer是必需的 type 参数，不是注释；漏掉它，Composer 2.x+ 直接忽略该配置 - URL 必须 HTTPS 开头且以
/结尾，否则请求路径拼错（如变成/composerpackages.json）导致 404
阿里云、腾讯云、华为云镜像 URL 怎么写才不报错
不同镜像的路径结构差异大，不能简单替换域名。直接套用以下实测可用地址，避免踩坑：
- 阿里云：
https://mirrors.aliyun.com/composer/（最稳，同步及时） - 腾讯云：
https://mirrors.cloud.tencent.com/composer/ - 华为云：
https://mirrors.huaweicloud.com/repository/php/（注意路径含/repository/php/，不是/composer/） - 清华源已下线，中科大同步略慢，日常不推荐优先使用
所有 URL 末尾的 / 不能省——华为云和腾讯云严格校验，阿里云虽宽松但为一致性建议统一加上。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
切换后 vendor 还是慢？关键两步不能跳
镜像已生效，但 composer.lock 里记录的仍是 packagist.org 的 dist.url，Composer 会先尝试这个旧地址，失败后才 fallback（且不保证成功）。这不是配置失败，而是缓存和 lock 文件未刷新。
- 执行
composer clear-cache清掉旧元数据缓存 - 再运行
composer update --lock强制重写composer.lock中所有包的下载链接 - 验证方式：打开
composer.lock，找任意一个包的dist.url字段，应为类似"https://mirrors.aliyun.com/composer/dists/..."
只切镜像不更新 lock，依赖还是从旧地址拉；只清缓存不刷新 lock，新镜像也用不上。
CI/CD 或团队协作时，全局配置容易被覆盖
宝塔面板用 www 用户执行命令，但 -g 写的是 root 的配置；Docker 构建时用户权限不同；Git 提交的 composer.json 里若有 repositories 字段，会直接覆盖全局设置。
- CI 场景建议改项目级配置并提交到 Git：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 若项目
composer.json已有"repositories"字段且为数组格式（如[{}]），composer config命令会失败，需先手动转成对象格式（如{"packagist": {}}） - 检查
composer.json是否硬编码了"url": "https://packagist.org"或空"repositories": []，这些都会让全局配置失效
最易被忽略的是 --lock 刷新和 clear-cache 的组合操作——它和镜像配置本身同等重要，但常被跳过。
