高效利用Composer，中文镜像配置是基础！-composer-PHP中文网

composer config -g repo.packagist 命令未生效主因是键名错（应为repo.packagist而非repos.packagist）、漏写type值“composer”、url末尾缺/，三者任一出错即静默回退官方源；验证须输出完整json对象如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。

高效利用composer，中文镜像配置是基础！

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

大概率是三个硬性条件漏掉一个：键名写成 repos.packagist（多了一个 s）、漏掉 composer 这个 type 值、URL 末尾没加 /。这三处任一出错，Composer 2.x 都会静默 fallback 到官方源，不报错也不提示。

验证是否写入成功，直接运行：composer config -g repo.packagist。输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。空、null、报错或只返回 URL 字符串（新版行为），都说明配置失败。

repo.packagist 是固定键名，不能写成 packagist.org 或 repositories.packagist
composer 是 type 值，不是可选参数，必须显式写出
URL 必须是 HTTPS，且末尾带 /，例如 https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌

项目级配置怎么避免覆盖私有仓库

项目已有 repositories 字段时，手动编辑 composer.json 极易出错——漏方括号、引号不全、误删已有源。正确做法是让 Composer 自动合并：

进项目根目录，执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加 -g）

Discussion Composer

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

下载

如果 composer.json 原本是 "repositories": {}，命令会转为标准数组格式并追加 packagist 条目
如果原本是 "repositories": []，命令会向数组末尾插入新项，不破坏原有私有源
千万别写 "packagist": false，这会导致基础包（如 php、ext-json）校验失败

宝塔/CI 环境里全局配置为啥不起作用

全局配置写在 /root/.composer/config.json，但它只对 root 用户生效。宝塔「一键部署」、PHP 管理器、计划任务默认以 www 用户运行，根本读不到 root 的配置。

解决方法很直接：先确认实际执行用户（比如 whoami 或查日志 UID），再针对性配置：

给 www 用户配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
GitHub Actions 中，确保 run 步骤未用 sudo 切换用户，否则配置写进了错误账户
改完后务必执行 composer clear-cache，否则旧缓存可能掩盖配置生效状态