项目级配置比全局更可靠，因其写入composer.json可git提交、团队行为一致，且不受ci/cd用户隔离、docker无~/.composer目录等环境限制；全局配置在runner/www用户下常因权限或路径不可见而失效。
项目级配置为什么比全局 config -g 更可靠
全局配置 composer config -g repo.packagist 看似一劳永逸，但在 CI/CD、Docker、宝塔或多人协作中极易失效：CI runner 用户和你本地用户不同，~/.composer/config.json 根本不共享；Docker 容器里甚至没这个目录。项目级配置直接写进 composer.json，Git 提交即同步，所有人执行 composer install 行为一致。
常见踩坑点：
- 误用
-g参数改项目配置，结果只影响当前终端会话，换目录就失效 - 项目已有
"repositories": []（数组），运行composer config repo.packagist ...会报错，必须先手动改成"repositories": {}（对象） - 团队成员没提交修改后的
composer.json，新同事拉代码后仍走官方源
为每个项目单独设镜像：一条命令搞定
进入项目根目录（确保有 composer.json），运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动在 composer.json 中写入 "repositories" 字段，且只添加 "packagist" 子项，不覆盖已有私有源（前提是原 repositories 是 JSON 对象而非数组）。
关键细节：
-
repo.packagist是键名，不能写成repos.packagist或packagist.org -
composer是 type 值，必须显式写出，不是可选参数 - URL 必须以
/结尾，https://mirrors.tuna.tsinghua.edu.cn/composer/✅，https://mirrors.tuna.tsinghua.edu.cn/composer❌
混合使用私有源 + 公共镜像的顺序陷阱
如果你的项目同时依赖内部 Satis 仓库和阿里云镜像，repositories 数组顺序决定谁“先说话”——Composer 只查第一个返回 200+ 有效 JSON 的源，后续全跳过。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确顺序示例（写入 composer.json）：
{
"repositories": {
"my-internal": {
"type": "composer",
"url": "https://pkg.internal.company.com"
},
"packagist": {
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
}
}
错误做法：
- 把阿里云镜像放前面，私有包名又和 Packagist 上某包重复 → 私有包永远装不上
- 私有源类型写成
"type": "vcs"却想代理 ZIP 包 → 类型不匹配，请求直接失败 - 漏掉
"packagist.org": false放在末尾 → 镜像返回 404 时仍会兜底连官方源，暴露内网行为或拖慢流程
验证镜像是否真生效，别信缓存
运行 composer config repo.packagist 只能看配置值，不能证明网络请求走的是镜像。真正有效的验证方式是绕过缓存触发真实请求：
composer show monolog/monolog --no-cache
观察输出中的 Available from 行，或加 -v 查日志：
composer update -v 2>&1 | grep "Fetching"
你会看到类似 Fetching https://mirrors.aliyun.com/composer/p2/monolog/monolog.json 的地址。如果还看到 packagist.org 或 packages.json 请求，说明配置被覆盖、顺序错或禁用语句缺失。
最常被忽略的一点：换镜像后没删 composer.lock 和 vendor，旧 lock 文件里记录的是官方源 hash，即使镜像生效，Composer 仍按 lock 里的 dist URL 下载——此时换镜像毫无意义。
