正确配置 Composer 镜像需四要素缺一不可：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏任一要素将静默失效且不报错。

composer config -g repo.packagist 命令必须带全四要素

不是“随便敲一行就能用”，漏掉任意一个都会静默失效，且不报错——你看着 composer install 还在卡在 Loading composer repositories，其实早就退回到 packagist.org 了。

• -g：全局配置，不加就只改当前项目，换目录即失效
• repo.packagist：键名必须是单数、全小写、带 repo. 前缀；写成 repos.packagist 或 packagist 都存进无效字段
• composer：这是 type 值，不是注释，不是可选，省略会导致 fallback 到默认源
• https://mirrors.aliyun.com/composer/：URL 必须 HTTPS 开头，且末尾带 /，少斜杠会拼出 /composerpackages.json 直接 404

正确命令只有一行：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

验证是否真生效，别信“运行完就完了”

运行完命令不等于镜像已启用。Composer 不提示成功，也不校验 URL 可达性，只默默存配置——而配置错，它就当没这回事。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 必须立刻验证：composer config -g repo.packagist
• 输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
• 如果输出 null、空、No repositories configured，说明配置失败，回退到官方源
• 如果输出里没有 "type": "composer"，哪怕 URL 对，也会 fallback

换了镜像还是慢？大概率是 composer.lock 没刷新

镜像配置成功 ≠ 下载走镜像。Composer 优先读 composer.lock 里的 dist.url，而旧 lock 文件记录的仍是 packagist.org 的地址。

• 执行 composer clear-cache 清掉本地元数据缓存
• 再跑 composer update --lock 强制重写 lock 文件中的所有 dist.url
• 检查 lock 文件里任意包的 dist.url 字段，应为类似 "https://mirrors.aliyun.com/composer/dists/..."
• 新项目用 composer create-project 时，记得加 --repository-url=https://mirrors.aliyun.com/composer/，否则它绕过全局配置直连 packagist.org

团队协作或 CI 环境下，全局配置可能不生效

-g 写的是当前用户家目录下的 ~/.composer/config.json。CI 脚本常以 www 或 runner 用户运行，但你配的是 root 或自己账户——配置根本没被读到。

• CI 场景建议改项目级配置：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
• 该命令会安全写入项目 composer.json 的 repositories 字段，且会被 Git 跟踪
• 注意前提：原 repositories 必须是对象（如 "repositories": { "packagist": {} }），不能是数组；否则命令报错，得先手动改成对象格式
• 别在 composer.json 里硬编码多个镜像 URL，容易触发 Repository has no URL defined 错误

阿里云镜像目前同步最稳，但新包发布后仍可能有 1–2 小时延迟。遇到 Could not find package，先清缓存、再切回官方源验证，别急着重装 Composer。