Composer config -g repo.packagist 命令不生效是因为键名错（如repos.packagist）、漏type值composer、URL末尾缺/，三者任一出错即静默回退官方源；验证须输出完整JSON对象。
composer config -g repo.packagist 命令为什么没输出或不生效
它根本不是“没反应”，而是写错了就静默忽略——Composer 2.x 遇到非法配置，直接 fallback 回 https://packagist.org，连 warning 都不打。常见错误有三个：
• repo.packagist 写成 repos.packagist（多一个 s）或 packagist.org
• 漏掉中间的 composer ——这不是注释，是必须声明的 type 值
• URL 少了末尾斜杠：https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌（拼出 /composerpackages.json 导致 404）
验证是否真写进去了，只看这一句：composer config -g repo.packagist。必须返回完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；返回空、null 或报 Key not found，说明压根没写对。
项目级配置覆盖全局镜像怎么办
只要项目根目录的 composer.json 里有 repositories 字段，全局配置就自动失效——这是 Composer 的设计逻辑，不是 bug。
检查方法很简单：composer config repo.packagist（不带 -g），有输出说明项目自己写了镜像；没输出才轮到读全局。
容易踩的坑：
• 即使 "repositories": {} 这种空对象，也会触发“禁用默认源”
• 执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）会全量替换整个 repositories 字段，把你原有的私有 Git 源（比如 "my-private": {"type": "vcs", ...}）直接清空
• 别手动写 "packagist": false，这会导致 php、ext-json 等基础约束校验失败
安全做法：手动编辑 composer.json，确保 repositories 是数组，首位放 {"packagist.org": false}，第二位才是镜像源，并保留其他自定义源。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
宝塔、CI 或 Docker 里镜像不生效
全局配置写在 ~/.composer/config.json，但它只对当前用户生效。宝塔默认以 www 用户运行命令，GitHub Actions 默认不读全局配置，Docker 容器里更是各跑各的家目录。
解决方法：
• 宝塔里先确认执行用户（比如查日志 UID 或运行 whoami），再针对性配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• CI 脚本里别依赖全局配置，改用环境变量：COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install
• Dockerfile 中，如果用非 root 用户，得在构建阶段显式切换用户后再配，或者干脆把镜像 URL 注入到 composer.json 里再 commit
换源后 composer install 报 hash 不匹配
这不是网络问题，是旧 composer.lock 文件里记录的包哈希和 dist URL 来自官方源，切换镜像后，Composer 仍按原路径去阿里云找 zip 包——但镜像服务的内部路径映射与 packagist.org 不同，校验必然失败。
必须做两件事：
• 删掉项目里的 vendor/ 目录
• 删掉 composer.lock 文件
再执行 composer install（注意不是 update），让 Composer 重新解析依赖、生成适配镜像的新 lock 文件。
如果团队协作，记得把删 lock 文件的操作写进 README 或 CI 脚本里——否则新人拉代码后直接 install，还是会卡在 hash 校验上。
