composer config --global不能用于团队方案，因其仅修改本地~/.composer/config.json，无法纳入Git版本控制，CI/CD流水线（如GitHub Actions）不读取该文件，新人clone后首次composer install会fallback至packagist.org导致超时或报错，且易被误覆盖、私有源丢失、配置不一致。
不行，光共享镜像配置不解决速度问题——真正卡顿的根源是配置没进版本控制、没覆盖所有执行环境、也没处理私有源和公共源的优先级冲突。
为什么composer config --global不能当团队方案用
这条命令只改本地 ~/.composer/config.json，Git 看不见，CI/CD 流水线（比如 GitHub Actions）压根不读它，新人 clone 项目后第一次 composer install 就会 fallback 到原始 packagist.org，直接超时或报 Could not find package。
- CI 构建失败：流水线容器默认无全局配置，镜像源失效 → 下载慢或中断
- 私有包丢失：如果团队用了内部 Packagist，但只在自己机器上
config --global加了源，别人运行时根本找不到包 - 配置被覆盖：某人误执行
composer config --global repo.packagist composer https://packagist.org，全队本地环境瞬间退回到公网源
必须把 repositories 写进 composer.json 并提交 Git
这是唯一能让所有人、所有环境（本地、CI、Docker）、所有命令（install/update/require）自动生效的方式。Composer 会优先读取项目级配置，且该文件可被版本控制、审查、回滚。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 私有源必须放
repositories数组最前面，否则请求可能被路由到公网源而失败 - 必须显式保留
"type": "packagist.org"条目作为兜底，否则 Composer 会跳过默认源（即使你没删它） - URL 末尾斜杠不能少：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（返回 404） - 类型写
"type": "composer"，不是"type": "packagist"或"type": "mirror"—— 后两者无效
自建镜像服务后，怎么让团队无缝切换
如果你已部署内网镜像（如 https://mirror.internal.company.com），别让成员各自执行 config --global，而是统一注入到基础环境里：
- 在团队共用的 Dockerfile 中加一行：
RUN composer config -g repo.packagist composer https://mirror.internal.company.com - 在 Ansible 初始化脚本或 macOS/Linux 的 setup.sh 里执行同一条命令
- 确保该域名能被所有开发机和 CI 节点 DNS 解析，且证书可信（避免
SSL certificate problem） - 验证是否生效：
composer config -g repo.packagist输出应为对应 URL 字符串或 JSON 对象
临时调试时别乱用 --repository-url
这个参数优先级最高，适合排查网络或验证新镜像，但极易踩坑：
-
composer require foo/bar --repository-url=xxx不生效，它只对install和update有效 - 它会完全覆盖
composer.json里的repositories，私有包源瞬间失效 - CI 脚本中若用它，必须配合
-vvv打印实际请求 URL，否则无法确认是否真走对了源 - 不要把它写进
scripts字段——没人能保证每次执行都带这个参数
最常被忽略的一点：哪怕镜像地址正确、repositories 配置无误，如果 composer.lock 是旧的（比如上次用的是公网源生成的），composer install 仍会尝试从原始源拉取 dist 包。所以每次切换镜像后，必须运行 composer update --lock 或至少 composer install --no-scripts 强制刷新 lock 文件中的 URL 引用。
