Composer新手必学：中文镜像快速配置-composer-PHP中文网

配错三个字符镜像就失效：必须严格使用 repo.packagist（单数、带 repo. 前缀）、type 为 composer、url 为 https://mirrors.aliyun.com/composer/（https 开头+末尾斜杠），且必须加 -g 才生效。

composer新手必学：中文镜像快速配置

配错三个字符，镜像就等于没配——不是慢，是根本没走镜像。

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

这条命令静默失败的概率极高，不是 Composer 报错，而是你压根没写进去。它只认 repo.packagist（单数、带 repo. 前缀），写成 repos.packagist、packagist.org 或 packagist 都无效。

composer 是必须显式写出的 type 值，不能省略、不能替换成 https 或其他字符串
URL 必须是 https://mirrors.aliyun.com/composer/ 这种格式：HTTPS 开头 + 末尾斜杠 / 缺一不可；少个 / 会导致请求路径变成 /composerpackages.json，直接 404
必须带 -g，否则只改当前目录下的 composer.json，换个项目就失效
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null、报错或返回 "https://packagist.org" 都代表失败

项目级配置比全局更可靠，尤其在 CI 和团队协作中

全局配置依赖当前用户家目录下的 config.json，但宝塔用 www 用户、GitHub Actions 用 runner 用户，它们根本读不到你本地的配置。项目级配置可提交进 Git，行为一致。

Discussion Composer

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

下载

进项目根目录（含 composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意去掉 -g）
该命令会自动在 composer.json 的 repositories 字段里安全追加，不覆盖已有私有源
如果 composer.json 里已有 "repositories": []（数组形式），命令会报错；此时需手动编辑，确保 "packagist": true 存在，且不要写成 "packagist": false
改完必须删掉 vendor/ 和 composer.lock，再跑 composer install（不是 update）

换源后还卡在 “Resolving dependencies”？镜像根本不负责这事

镜像只加速元数据拉取和 ZIP 包下载，不参与依赖解析。这个阶段卡住，和网络无关，典型原因有：

composer.json 里写了太宽的 PHP 版本约束，比如 "php": "^7.4 || ^8.0 || ^8.1 || ^8.2"，求解器暴力尝试组合
存在 "minimum-stability": "dev"，强制拉取不稳定分支，候选版本爆炸
composer.lock 被删或未提交，install 实际退化为 update
repositories 字段指向了已下线的私有源，Composer 逐个超时才 fallback
快速排查：进项目根目录，运行 composer config --list | grep repositories 看实际生效源；再跑 composer validate --strict 检查 lock 文件合法性

提速还要加这四个参数，光换镜像只解决一半问题

镜像解决了“下载慢”，但生产部署还卡在其他环节。这几个参数能实打实压缩时间：

--no-dev：跳过 require-dev（如 phpunit、phpstan），省掉 30–60% 时间
--prefer-dist：强制走 ZIP 包，避免 git clone 的 I/O 和网络开销
--optimize-autoloader（或 -o）：生成静态类映射，PHP 7.4+ 下可进 opcache
--no-cache：临时绕过缓存验证镜像是否真生效，看日志里请求的是哪个域名

别忘了清缓存：composer clear-cache（不是 composer cache-clear，后者已废弃）。缓存里存着旧的 packages.json 和 provider 元数据，Composer 会优先读缓存再校验远程地址——哪怕你已经切了镜像，它仍可能反复尝试从 https://packagist.org 拉取索引。