项目级配置是团队协作的唯一可靠选择，因全局配置不进git且ci环境读不到，而项目级配置写入composer.json并提交后可确保所有环境行为一致、可预测、可审计；执行composer config repo.packagist需严格满足单数小写、无-g、type必填、url以/结尾等条件；换镜像前必须删除vendor/和composer.lock，否则仍走官方源。
项目级配置为什么是团队协作的唯一可靠选择
因为全局配置（composer config -g）不进 Git，CI/CD 构建时用的是干净容器或 runner 用户，根本读不到你本地 ~/.composer/config.json；而只要项目 composer.json 里有 repositories 字段，Composer 就会无视全局配置——这不是“优先级更高”，是直接跳过。
项目级配置写进 composer.json 并提交 Git，所有成员、所有 CI 节点、所有 Docker 构建环境，启动时自动加载同一套源定义，行为可预测、可审计、可回滚。
- CI 流水线（如 GitHub Actions）拉代码后直接
composer install，无需额外配置步骤 - 新人克隆项目后，
composer install默认走镜像，不会因本地没配-g就卡在Loading composer repositories - 私有包源和公共镜像可以共存于同一
repositories数组，顺序无关，解析逻辑不变
执行 composer config repo.packagist 的硬性条件
这条命令看似简单，但漏掉任一细节就会静默失效：不报错、不提示、也不写入，最终还是走官方源。
-
repo.packagist必须是单数、小写、无 s——写成repos.packagist或packagist.org都无效 - 必须省略
-g参数，否则改的是全局配置，不是当前项目 -
composer是必填的type值，不是注释，不能省略或写成mirror - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，少斜杠就 fallback 到官方源
验证是否写入成功：composer config repo.packagist 应输出类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；返回空或报错，说明没生效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
切镜像前必须清理 vendor/ 和 composer.lock
镜像只缓存元数据（packages.json），不托管实际 zip 包。如果 composer.lock 里 dist.url 还是 https://api.github.com/，Composer 就绕过镜像直连 GitHub——你看到的“卡在 Downloading”其实是根本没走镜像。
- 旧
composer.lock记录的是旧源的哈希值，和镜像返回的元数据不匹配，必然失败 - 必须先删掉
vendor/和composer.lock，再运行composer install --no-cache - 不要保留旧 lock 文件试图“兼容”，它和新镜像源之间没有兼容性可言
项目级配置容易被忽略的结构陷阱
composer.json 中 repositories 字段的结构决定命令能否安全执行。现代 Composer 默认生成数组形式（"repositories": []），但老项目或手动编辑可能写成对象（"repositories": {} 或 "repositories": {"packagist.org": false}）。
- 如果
"repositories"是空对象{}，composer config repo.packagist会覆盖整个字段，误删私有源 - 如果
"repositories"是数组[]，该命令默认追加条目，相对安全 - 最稳妥的做法：手动确认
repositories是数组，首位插入{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，已有私有源保留在后面
真正复杂的地方不在命令本身，而在于 composer.lock 的不可见依赖链——它把源地址、包哈希、下载路径全锁死了，换镜像却不重建 lock，等于给新车装上旧地图，方向没错，路早没了。
