composer config -g repo.packagist 命令不生效并非网络问题，而是必须同时满足三个硬性条件：键名严格为单数 repo.packagist（非 repos 或 packagist.org）、第二个参数必须显式写 composer（type 值不可省略）、URL 必须是 HTTPS 且末尾带 /（如 https://mirrors.aliyun.com/composer/），任一缺失即静默回退至官方源；验证需输出完整 JSON 对象，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
composer config -g repo.packagist 命令为什么总不生效
不是网络慢，是三个硬性条件缺一不可：repo.packagist（单数，不能写成 repos.packagist 或 packagist.org）、composer（必须作为第二个参数显式写出，不是可选注释）、URL 必须是 HTTPS 且末尾带 /（比如 https://mirrors.aliyun.com/composer/✅，少斜杠会拼出 /composerpackages.json 导致 404）。任一出错，Composer 2.x 都静默 fallback 到 https://packagist.org，不报错也不提示。
验证是否真写入：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。返回 null、空、Key not found 或只输出 URL 字符串（新版行为），都说明失败。
全局配置和项目级配置哪个该用
全局配置省事，但只对当前 shell 用户生效；项目级配置写进 composer.json，能被 Git 跟踪、CI 流水线读取、协作者共享，更可靠。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 composer https://mirrors.aliyun.com/composer/ - 项目级推荐命令自动写入：
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/（不带-g），它会安全追加到repositories字段，不破坏已有私有源 - 多用户环境（如宝塔、Docker）下，Web 服务常以
www用户运行，需切换用户执行：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
换源后还是卡在 “Loading composer repositories” 怎么办
镜像只加速元数据拉取和 ZIP 下载，但 Composer 会优先读缓存和旧 composer.lock，哪怕你刚配好镜像，它也可能还在用 packagist.org 的地址。
- 先清缓存：
composer clear-cache - 删掉项目下的
vendor/和composer.lock - 再跑
composer install -vvv，观察日志末尾是否出现mirrors.aliyun.com或mirrors.tuna.tsinghua.edu.cn；如果还看到packagist.org/packages.json，说明没走通 - 某些镜像（如清华源）要求
secure-http: true，若composer diagnose显示signature verification: disabled，存在安全风险，需检查证书或换源
阿里云、清华源、华为云 URL 差异要注意什么
不同镜像的路径结构和协议要求不一致，直接复制 URL 容易踩坑：
- 阿里云：
https://mirrors.aliyun.com/composer/（末尾必须带/） - 清华源：
https://mirrors.tuna.tsinghua.edu.cn/composer/（同样需尾斜杠，且部分版本要求启用secure-http） - 华为云：
https://mirrors.huaweicloud.com/repository/php/composer/（路径含/repository/php/，不能直接用根域名） - 已停用的旧地址（如
https://packagist.laravel-china.org、https://packagist.phpcomposer.com）请勿使用，2025 年底已下线或返回 404
最易被忽略的是：改完配置后没删 composer.lock，导致依赖仍从旧源解析；还有人手动编辑 config.json 格式出错或权限不足，不如用 composer config 命令安全写入。
