composer config -g repo.packagist 总不生效是因为必须同时满足三个硬性条件：键名必须为 repo.packagist（单数、大小写敏感）、type 值必须显式写 composer、URL 必须 HTTPS 且以 / 结尾，缺一则静默回退官方源；验证需输出完整 JSON 对象。
全局镜像配置不是“改个 URL 就完事”，而是必须同时满足三个硬性条件：键名 repo.packagist、type 值 composer、URL 以 https:// 开头且末尾带 /，缺一即静默回退官方源。
为什么 composer config -g repo.packagist 总不生效
命令没报错 ≠ 配置成功。典型表现是 composer install 仍卡在 Loading composer repositories from packagist.org。根本原因只有三个：
-
repo.packagist键名必须一字不差：写成repos.packagist（多 s）、packagist.org或大小写混用（如Repo.Packagist）全被忽略 - 中间的
composer是 type 值，不是可选参数，也不能留空或替换成vcs、package -
https://mirrors.aliyun.com/composer/必须是 HTTPS 且以/结尾：少斜杠会拼出/composerpackages.json导致 404；HTTP 地址在 Composer ≥2.5 中被强制拒绝
怎么验证配置是否真正落盘
别信终端输出“OK”，必须手动查：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 2>&1 | grep "mirrors.aliyun.com"，日志里应出现该域名
全局配置 vs 项目级配置：谁在真正起作用
Composer 加载顺序固定：项目 composer.json > 全局 config.json > 默认值。哪怕全局配对了，只要项目里有 "repositories" 字段，就完全屏蔽全局镜像。
- 本地开发机用全局最省事：
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） - 项目已有
"repositories": []（数组格式），该命令会直接报错；需先手动改成"repositories": {}（对象格式）再重试 - 切勿手写
"packagist.org": false——这会让 Composer 屏蔽基础包校验，导致require失败
换源后还是慢或报错，下一步查什么
镜像只改元数据下载路径，不参与依赖解析。如果 composer update 卡在 Resolving dependencies，和镜像无关：
- 检查
composer.json的版本约束是否太宽（如"php": "^7.4 || ^8.0"） - 确认
require-dev是否引入了大量冲突包 - 删掉
vendor/和composer.lock，再跑composer install—— 否则旧 lock 文件仍按原地址解析 - Windows 用户改完要重开终端；Git Bash 下
%APPDATA%不展开，建议切 PowerShell 或 cmd 执行
最容易被忽略的是：全局配置只对当前 shell 用户生效。CI 流水线里用 sudo composer config -g，写的是 root 配置，但构建实际跑在 runner 或 www 用户下，得配对应用户的 ~/.composer/config.json。
