项目级配置命令为composer config repo.packagist composer https://mirrors.aliyun.com/composer/，不加-g参数写入当前项目composer.json的repositories对象中，键名必须为packagist且type不可省略；若原为数组需先转为空对象再追加，否则报错；生效后需删除vendor和composer.lock并--no-cache重装以避免旧锁文件残留官方源地址。
在项目根目录执行 composer config 命令
直接进项目文件夹，运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动往当前项目的 composer.json 里写入 repositories 配置，不带 -g 参数，所以只影响这个项目。
常见错误：误加 -g 导致改了全局配置；或把 repo.packagist 写成 repos.packagist（多一个 s），结果静默失败，composer.json 里啥也没变。
- 命令成功后，
composer.json顶层会出现类似这样的结构：
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
}
注意："packagist" 是固定键名，不是你随便起的；"type": "composer" 不能省，否则 Composer 2.x 会忽略它。
已有 repositories 数组时怎么安全追加
如果项目原本就定义了私有源（比如用 type: "package" 或 type: "composer" 指向内部仓库），composer.json 里的 repositories 很可能是数组形式。此时直接运行上面的命令会报错：Could not add repository: repositories must be an object。
解决办法分两步：
- 先手动把
"repositories": []改成"repositories": {}（空对象），再运行composer config repo.packagist ... - 改完后，再把其他私有源以键值对形式补进去，例如：
"my-private": { "type": "composer", "url": "https://private.example.com" } - 千万别用数组格式混搭对象——Composer 不认这种写法，会跳过全部源
验证方式：运行 composer config repo.packagist（不带 -g），输出应为完整 JSON 对象，含 type 和 url 字段。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
换源后 composer install 还卡住？先清锁文件
镜像生效了，但旧的 composer.lock 里还记着官方源地址，Composer 会尝试从 packagist.org 拉取元数据，导致卡在 Loading composer repositories。
必须重生成锁文件：
- 删掉
vendor/和composer.lock - 运行
composer install --no-cache（加--no-cache避免读本地缓存里的旧元数据） - 或者更稳妥：先
composer update --lock --no-cache，再composer install
如果团队协作，记得把新生成的 composer.lock 提交到 Git —— 否则别人拉代码后依然走官方源。
为什么不用全局配置而选项目级
全局配置（composer config -g）写在 ~/.composer/config.json，但它在很多实际场景下根本不起作用：
- 宝塔面板、Docker 容器、CI 流水线（如 GitHub Actions）默认以
www或runner用户运行，读不到你个人用户的全局配置 - 多人协作时，有人配了全局镜像，有人没配，
composer install行为不一致，容易引发依赖差异 -
composer.json提交后，所有人开箱即用，不需要额外文档说明“请先配镜像”
项目级配置唯一的代价是：每次新建项目都要跑一次命令。但比起排查“为什么他能装我不能装”，这点操作成本几乎可以忽略。
