从零开始的Composer镜像配置指南-composer-PHP中文网

composer config -g repo.packagist 无效是因为三个硬性条件未同时满足：键名必须为单数 repo.packagist、type 值必须显式写 composer、url 必须 https 且末尾带 /；任一缺失即静默回退官方源，且不报错不提示。

从零开始的composer镜像配置指南

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

它根本没写进去，不是网络慢，是命令本身静默失败。Composer 对这个配置项校验极严，漏掉任意一个硬性条件就回退到 https://packagist.org，且不报错、不提示。

repo.packagist 必须是单数形式——写成 repos.packagist 或 repository.packagist 全无效
第二个参数 composer 是 type 值，不是可选注释，省略或写成 package 都会导致 fallback
URL 必须是 HTTPS 且末尾带斜杠：https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌（少斜杠会拼出 /composerpackages.json 404）
验证是否生效：运行 composer config -g repo.packagist，输出必须是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；返回空、null 或 Key not found 就说明没写成功

全局配置 vs 项目级配置，该用哪个

全局配置只在你当前 shell 用户下生效，CI/CD、宝塔、Docker 容器里基本读不到——因为它们用的是 www、runner 或其他用户，家目录下根本没有 ~/.composer/config.json。

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 composer https://mirrors.aliyun.com/composer/
团队协作或部署环境必须用项目级：进项目根目录（含 composer.json），执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
项目级配置会自动写入 composer.json 的 repositories 字段，key 固定为 "packagist"；如果已有 "repositories": []（数组），命令会报错，需先手动改为 "repositories": {}
注意优先级：项目级 > 全局 > 默认源。只要 composer.json 里有 repositories，全局镜像就完全被忽略

换源后 still 卡在 Loading composer repositories

不是镜像没生效，是 Composer 在读旧缓存和旧 lock 文件。它不会自动刷新元数据地址，哪怕你刚配好镜像，composer.lock 里仍记着 packagist.org 的 URL。

必须先清缓存：composer clear-cache
删掉项目下的 vendor/ 和 composer.lock
再执行 composer install（不是 update），否则 composer.lock 重建时仍可能沿用旧源
加 -vvv 观察日志：composer install -vvv 2>&1 | grep -i "mirrors.aliyun.com"，确认请求发往镜像域名

宝塔、Docker、GitHub Actions 里镜像不生效

这些环境默认不用你的用户配置，而是用各自服务账户的环境。直接跑 composer config -g 没用，因为配置写到了错误的 ~/.composer/config.json 路径。

宝塔面板：PHP 进程以 www 用户运行，需切换用户执行：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Docker CI：在构建阶段显式写入，例如 RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
GitHub Actions：用 setup-php action 时，加 tools: composer 参数，并在 steps 中提前运行 config 命令
别忘了检查 PHP CLI 环境：宝塔常禁用 proc_open、putenv，这些函数被禁会导致 Composer 启动失败，根本走不到镜像环节