Composer config -g repo.packagist 总不生效是因为键名必须为单数repo.packagist、type值composer不可省略、URL须以https://开头且末尾带/，三者缺一即静默失效并返回null或空对象。
composer config -g repo.packagist 为什么总不生效
因为命令写错三个地方：键名必须是 repo.packagist（不是 repos.packagist），composer 是强制 type 值（不能省），URL 必须以 https:// 开头且末尾带 /。漏一个，就静默失效——composer config -g repo.packagist 输出 null 或空对象，但你不报错、也不提醒。
验证是否成功，只看这一行输出：
composer config -g repo.packagist
正确结果必须是完整 JSON 对象，例如：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
-
repo.packagist写成repos.packagist→ 配置写进去了，Composer 不识别 - 漏掉
composer参数 → 新版 Composer 直接 fallback 到官方源，旧版可能忽略整条配置 - URL 少末尾斜杠（如
https://mirrors.aliyun.com/composer）→ 请求变成/composerpackages.json，404 后静默退回到https://repo.packagist.org
全局配置路径到底写在哪
Composer 不读你“以为”的那个 ~/.composer/config.json，它只认 $COMPOSER_HOME 指向的路径，或默认位置（Linux/macOS 是 ~/.config/composer/config.json，Windows 是 %APPDATA%\Composer\config.json）。多个路径共存时，只加载一个。
查真实路径，运行：
composer config --global --list --verbose
第一行就是实际读取的文件。常见陷阱：
-
~/.composer/config.json和~/.config/composer/config.json同时存在 → Composer 2.0+ 只读后者，前者被完全忽略 - Git Bash 中执行
composer config --global→%APPDATA%不展开，写入失败却不提示 - 设了
COMPOSER_HOME但指向空目录或权限不足 → 写入静默失败，composer config --global --list输出为空
项目级 config 和全局 config 的作用范围差异
composer config 默认改当前项目的 composer.json 里的 config 字段；加 --global 才改全局配置。但关键区别在于：仓库源（repositories）这类配置，**项目级写法不走 config 字段，而必须写进 repositories 字段**。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型误操作：
- 运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（没加-g）→ 实际写进composer.json的"config": { "repo.packagist": ... }，但该字段对源地址无效，Composer 完全无视 - 想配私有 Git 仓库，却用
composer config repositories.myrepo vcs https://git.example.com/pkg.git→ 正确，它会写进repositories对象里 - 项目
composer.json里已有"repositories": []（数组）→ 上述命令会失败；必须先手动改成"repositories": {}（对象）
项目级镜像配置真正生效的写法是：
composer config repositories.packagist composer https://mirrors.aliyun.com/composer/
如何判断当前生效的是哪一层配置
composer config --list 显示的是多层合并后的扁平化结果，不标注来源、不保留嵌套结构，容易误判。比如看到 cache-dir 是 /tmp/cache，你不知道它是来自全局还是项目级覆盖。
精准排查方式：
- 查全局单个字段：
composer config --global cache-dir - 查项目单个字段：
composer config cache-dir - 查仓库列表（避免点号路径误导）：
composer config repositories，直接输出数组结构 - CI 脚本中快速定位关键路径：
composer config --global --list | grep -E "(home|cache-dir)"
特别注意：github-oauth、http-basic 这类凭据配置，必须用 --global，写进项目 composer.json 不生效且被安全机制拒绝。
最常被忽略的点：项目 composer.json 里如果写了 "packagist.org": false 或 "packagist": false，哪怕全局镜像配得再准，也会被彻底禁用——这种开关级配置优先级最高，且不报错、只沉默跳过。
