composer config -g repo.packagist 命令生效需同时满足三个硬性条件：键名必须为单数 repo.packagist、type 值必须显式写 composer、URL 必须 HTTPS 且以 / 结尾，任一不符即静默回退官方源。
全局镜像配置只有一条命令能真正生效，其余写法基本都静默失败——不是网络问题，是 Composer 对字段校验极严，错一个字符就不认。
composer config -g repo.packagist 命令为什么总不生效
它不报错，但也不起作用，典型表现是执行完 composer install 仍卡在 Loading composer repositories from packagist.org。根本原因只有三个硬性条件没满足：
-
repo.packagist键名必须一字不差：写成repos.packagist（多 s）、mirror、packagist.org或大小写混用（如Repo.Packagist）全被忽略 - 中间的
composer是type值，不是可选参数，也不能替换成vcs、package或留空 - 镜像 URL 必须是 HTTPS 且以
/结尾：https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404
验证是否真的写进去了
别信“命令跑完了”，必须手动验证：
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 repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果输出为空、
null、Key does not exist或仍是https://packagist.org，说明配置压根没写进去 - 再补查一次：
composer diagnose看Repo.packagist.org行是否显示你的镜像地址 - 临时加
--no-cache跑一次composer update --no-cache -vvv，日志里应出现mirrors.aliyun.com的请求域名
全局配置 vs 项目级配置：什么时候该用哪一种
全局配置写入 ~/.composer/config.json（Windows 是 %APPDATA%\Composer\config.json），优先级高于项目级，但只对当前 shell 用户生效：
- 个人开发机用全局最省事：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 团队协作、CI/CD、宝塔或 Docker 环境必须用项目级：执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g），它会安全追加到项目composer.json的repositories字段首位 - 注意：
composer config repo.packagist会**完全覆盖**整个repositories字段，已有私有仓库配置会被清空；若项目已有"repositories": []，需先手动改成"repositories": {}再重试
换源后还是慢或报错，下一步查什么
镜像只改下载路径，不参与依赖解析。如果 composer update 卡在 Resolving dependencies，和镜像无关：
- 检查
composer.json中的 PHP 版本约束是否太宽泛，比如"php": "^7.4 || ^8.0"会让解析器尝试大量组合 -
require-dev里有没有未锁定版本的工具包，如"phpunit/phpunit": "^10.0" - 有没有大量
dev-main或dev-develop分支依赖 - 换源后务必清缓存：
composer clear-cache，删掉vendor/和composer.lock，再跑composer install（不是update）
最容易被忽略的是：项目级 repositories 字段一旦存在，全局配置就彻底失效，且 Composer 不提示、不警告——你得自己意识到这点，而不是反复重试全局命令。
