composer config -g repo.packagist 命令需同时满足三个条件才生效：必须加 -g 参数、键名严格为 repo.packagist（非 repos.packagist 或 packagist.org）、type 值不可省略且为 composer；URL 必须 HTTPS 且末尾带 /，否则请求 packages.json 会 404。
composer config -g repo.packagist 命令为什么总不生效
因为这条命令有三个硬性条件，漏一个就静默失败：必须带 -g、键名必须是 repo.packagist（不是 repos.packagist 或 packagist.org）、composer 这个 type 值不能省。URL 还得是 HTTPS 且末尾带 /，否则请求路径拼成 /composerpackages.json 直接 404。
验证是否成功，只看这一行：composer config -g repo.packagist。输出应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果为空、null 或报错，说明没写对。
- Windows 用户在 PowerShell 里执行后，CMD 不会继承配置，得新开终端再试
- 用
sudo composer config -g写进了 root 用户的~/.composer/config.json，普通用户运行时根本读不到 - 某些 IDE（如 PHPStorm）自带 Composer 进程，可能读的是另一个用户目录下的配置
项目级 repositories 数组必须以 {"packagist.org": false} 开头
Composer 2.2+ 对 packagist.org 的请求是硬编码的，光在 composer.json 里加一条 "packagist.org": {"type":"composer", "url":"..."} 没用——它会被忽略，元数据仍走官方源。
正确写法是把 repositories 设为数组，并确保第一项是独立对象：{"packagist.org": false}。第二项才是镜像地址：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
"repositories": [
{"packagist.org": false},
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
]
-
{"packagist.org": false}必须是单独一项，不能合并进下一项 - 镜像
url末尾必须带/，否则packages.json请求 404 - 已有私有仓库？把它插在第二项之后，别动第一项
改完 composer.json 后 vendor 和 composer.lock 必须全删
常见错误：改完 repositories 就直接跑 composer update，结果包还是从 packagist.org 下。因为 composer.lock 里存的是旧 dist URL，Composer 完全不查新配置。
必须手动清理：
rm -f composer.lock && rm -rf vendor- 再执行
composer install，才会重新解析composer.json并生成新 lock 文件 - CI 脚本里也得加这两步，否则缓存会复用旧 lock，导致镜像配置形同虚设
团队协作中全局配置不如项目级配置可靠
发一个 ~/.composer/config.json 给所有人覆盖，看似统一，实则三处失效：
- CI/CD 容器没家目录，
~/.composer根本不存在 - 多项目共用同一全局配置，A 项目要禁用
packagist.org，B 项目要用私有源 + 镜像，无法差异化 - 新人漏执行、权限不对（比如 root 写了，但 PHP 进程以
www-data跑），配置就断了
真正能进 Git、被 CI 读到、新人拉代码即生效的，只有写死在 composer.json 里的 repositories 数组和 config 字段。镜像只是下载通道，版本一致性靠的是 composer.lock 提交进仓库，而不是源本身。
