Composer依赖管理工具中文镜像配置-composer-PHP中文网

composer config -g repo.packagist 命令没生效主因是命令写错却静默失败，必须严格满足：带 -g 参数、键名为 repo.packagist（非 repos）、type 值为 composer、url 为 https 且末尾含 /。

composer依赖管理工具中文镜像配置

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

90% 的配置失败不是网络问题，是命令写错但不报错——它会静默写入无效字段。执行 composer config -g repo.packagist 后返回空、null 或报 Key does not exist，说明根本没写进去。

必须同时满足三个硬性条件：

-g 不能省：缺了就只改当前目录的 composer.json，换项目即失效
键名严格为 repo.packagist（单数 repo，不是 repos.packagist）
composer 是 type 值，不是注释或可选参数；URL 必须 HTTPS 且末尾带 /，比如 https://mirrors.aliyun.com/composer/

正确示例：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。错任意一处，composer install 仍走 packagist.org。

宝塔、CI 或多用户环境里镜像不生效

全局配置写在 ~/.composer/config.json，但谁在执行命令，就读谁的配置文件。宝塔后台“一键部署”默认以 www 用户运行，GitHub Actions 用 runner 用户，它们都读不到你本地 root 或 admin 的配置。

验证方法：ps aux | grep composer 查实际 UID，或看宝塔日志里的执行用户。然后切换到对应用户重配：

sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
sudo -u runner composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

更稳妥的做法是跳过全局，直接进项目根目录执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/——它会自动写入 composer.json 的 repositories 字段，且能被 Git 跟踪。

Discussion Composer

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

下载

项目级配置时 repositories 格式容易出错

只要 composer.json 里存在 repositories 字段，全局镜像就自动失效。但很多人手写时踩坑：

写成数组格式 "repositories": []，会导致 composer config repo.packagist 命令报错，无法安全追加
误写 "packagist.org": false 却没定义新的 "packagist" key，结果所有包都拉不到
URL 少了末尾 /，请求变成 /composerpackages.json，直接 404

推荐写法（对象结构，key 固定为 packagist）：

{"repositories": {"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}}

改完必须删掉 vendor/ 和 composer.lock，再跑 composer install，否则旧 lock 文件里的 hash 可能和镜像元数据不匹配。

换镜像后还是卡在 Resolving dependencies

镜像只加速下载，不解决依赖解析慢的问题。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，和镜像无关，要查本地配置：

"php": "^7.4 || ^8.0" 这类宽泛版本约束会让 Composer 尝试大量组合
大量 "monolog/monolog": "dev-main" 这类未锁定的 dev 分支
require-dev 里塞了太多工具，尤其含复杂 autoload 规则的包
没启用并行下载：composer config -g parallel-downloads 8（Composer 2.2+ 支持，默认仅 3 线程）

临时验证镜像是否可用，不用动任何配置：composer install --repository-url=https://mirrors.aliyun.com/composer/。注意这个参数只对 install 和 update 生效，require 不支持。