composer config -g repo.packagist 命令总不生效是因为必须同时满足三个硬性条件：键名必须为单数 repo.packagist、第二个参数必须显式写 composer（type 值）、url 必须 https 且末尾带 /；任一缺失即静默回退官方源，验证需输出完整 json 对象。
composer config -g repo.packagist 命令为什么总不生效
它不会报错，但 composer install 依然卡在 Loading composer repositories，大概率是三个硬性条件漏掉一个：repo.packagist 键名写成 repos.packagist（多了一个 s）、漏掉中间的 composer 这个 type 值、URL 末尾没加 /。这三处任一出错，Composer 2.x 都会静默 fallback 到 https://packagist.org。
验证是否真写进去了？别信“命令没报错”，直接运行：
composer config -g repo.packagist
输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。空、null、报 Key does not exist，或只返回一行 URL 字符串，都说明配置失败。
全局镜像配置必须满足的三个硬性条件
缺一不可，否则静默失效：
-
repo.packagist是唯一合法键名 —— 写成repos.packagist、packagist.org、repositories.packagist全部无效 - 中间的
composer是强制type值，不是注释、别名或可选参数，必须显式写出 -
URL必须是 HTTPS，且末尾带/：例如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致请求路径变成/composerpackages.json，返回 404）
正确命令只有一种写法：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
换源后仍卡住？清缓存和确认生效路径是硬性步骤
镜像只加速元数据下载，但 Composer 会优先读取本地缓存和 composer.lock 中记录的旧地址。哪怕刚配好镜像，它也可能还在往 packagist.org 发请求。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须执行：
-
composer clear-cache（推荐，清全部） - 手动删缓存目录（Linux/macOS）：
rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer/ - Windows 下对应路径是：
%APPDATA%\Composer\Cache\repo\https---mirrors.aliyun.com-composer\
验证是否真走镜像：
- 运行
composer update -vvv - 搜索日志里的
GET行，确认域名是mirrors.aliyun.com或你设的镜像地址 - 不要只看下载速度；
composer diagnose输出中Repo packagist.org:后面的地址才是真实生效源
CI/CD 和多用户环境里镜像常“配了等于没配”
全局配置写在 ~/.composer/config.json，但它只对当前 shell 用户生效。Web 服务、计划任务、CI 构建往往以不同用户身份运行，导致镜像失效。
常见场景与应对：
- 宝塔默认用
www用户执行命令：需先确认用户，再运行sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Docker 容器内若未指定用户，可能以
root运行，但容器外配的是宿主机普通用户 - GitHub Actions 默认用
runner用户，-g配的是该用户的 home 目录，不是root - Git Bash 下
%APPDATA%不展开，建议切 PowerShell 或 cmd 执行全局命令
最稳的方式是运行 composer config --global --list，第一行输出的就是实际生效的配置文件路径。如果输出为空，说明写入失败或权限不足；如果输出里没有 repo.packagist，那镜像根本没落盘。
