composer config -g repo.packagist 总没效果是因为必须同时满足三个硬性条件：键名严格为单数 repo.packagist、中间参数必须显式写 composer（type 值）、URL 必须 HTTPS 且末尾带 /，任一缺失即静默回退官方源，验证需执行该命令并确认输出为完整 JSON 或有效 URL。

composer config -g repo.packagist 为什么总没效果

不是网络慢，是命令漏了关键三要素：键名必须是 repo.packagist（单数、全小写、无 s），composer 是必需的 type 值（不是可选参数，也不是注释），URL 必须以 https:// 开头且末尾带 /。任一缺失，Composer 就静默 fallback 到官方源，不报错、不提示，查 composer config -g repo.packagist 输出为空或 null 就是典型表现。

常见错误组合：

• composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/ —— 多了个 s，字段无效
• composer config -g repo.packagist https://mirrors.aliyun.com/composer/ —— 缺 composer type，被忽略
• composer config -g repo.packagist composer http://mirrors.aliyun.com/composer/ —— HTTP 被 Composer 2.0+ 拒绝
• composer config -g repo.packagist composer https://mirrors.aliyun.com/composer —— 少末尾 /，请求路径拼成 /composerpackages.json 直接 404

验证镜像是否真在生效

别信“好像快了”，得看三处：

• 运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
• 执行 composer diagnose，检查 “Repo” 行是否显示镜像地址；若仍是 https://packagist.org，说明被项目级 repositories 覆盖
• 删掉 vendor/ 和 composer.lock，再跑 composer install -vvv，日志里下载 URL 应含 mirrors.aliyun.com 或对应镜像域名

切完镜像 vendor 还是慢？关键在 lock 文件

镜像配置成功 ≠ 下载立刻走国内节点。composer.lock 里记录的是原始 dist.url，比如 https://api.github.com/repos/hyperf/cache/zipball/... 或 https://packagist.org/dists/...，Composer 会优先尝试这个地址，失败后才 fallback（且 fallback 不保证成功）。

Discussion Composer

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

下载

必须配对操作：

• 先执行 composer clear-cache 清掉旧元数据缓存
• 再运行 composer update --lock 强制重写 composer.lock 中所有包的 dist.url 字段，使其指向镜像源路径（如 https://mirrors.aliyun.com/composer/dists/...）
• 如果项目已有 composer.lock，跳过这步就白换镜像；新项目用 create-project 时建议加 --repository 参数直连镜像

CI/团队协作场景下该用全局还是项目级

全局配置（-g）在 CI 或宝塔等多用户环境里常失效——GitHub Actions 默认用 runner 用户，宝塔用 www 用户，它们的 ~/.composer/config.json 是空的，而你用 root 配的全局配置根本读不到。

更可靠的做法是项目级配置：

• 进项目根目录，执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
• 它会自动在 composer.json 顶层写入 "repositories": {"packagist": {...}}，不覆盖已有私有源（前提是原 repositories 是对象，不是数组）
• 改完必须删掉 vendor/ 和 composer.lock，再跑 composer install（不是 update）

最易被忽略的是 --lock 刷新和 clear-cache 的组合动作——只换源不刷 lock，依赖还是从旧地址拉；只清缓存不刷 lock，新镜像也用不上。