遇到Composer安装瓶颈？切换中文镜像立竿见影！-composer-PHP中文网

卡在downloading是因直连packagist.org受dns污染、tls阻塞和防火墙干扰，换镜像为必须操作；需严格满足repo.packagist键名、composer类型值、url末尾带/三条件，否则静默回退官方源。

遇到composer安装瓶颈？切换中文镜像立竿见影！

卡在 Downloading 不是网络差，是还在直连 packagist.org——物理距离 + TLS 握手慢 + 防火墙干扰，导致下载卡住或降到几 KB/s。换镜像不是“试试看”，而是必须做的第一步。

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

90% 的失败不是镜像站挂了，是你命令敲错了三个硬性条件，且 Composer 会静默 fallback 到官方源，完全不报错：

repo.packagist 不能写成 repos.packagist（多一个 s 就存进无效字段）
第二个参数必须是 composer（这是 type 声明，漏掉就等于没配）
URL 必须以 https:// 开头，且末尾带 /（https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌）

验证是否生效：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON；空、null、报错或仍是 https://repo.packagist.org，说明根本没写进去。

宝塔面板或 CI 脚本里换源后依然卡住

宝塔的「PHP 管理器」、「一键部署」、「计划任务」默认以 www 用户身份运行，而 composer config -g 默认写的是当前登录用户（如 root）的配置文件（路径为 /root/.composer/config.json），www 用户读不到。

Discussion Composer

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

下载

查实际执行用户：在宝塔【终端】中运行 whoami，或看计划任务设置里的“运行用户”
给 www 用户单独配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
CI/CD 更稳妥的做法是项目级配置（写进 composer.json），或每次用临时参数：composer install --repository=https://mirrors.aliyun.com/composer/

项目级配置如何避免清空私有仓库

执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）会向 composer.json 的 repositories 字段追加条目，但前提是该字段已存在且格式合法。否则可能被全量替换，导致已有的私有 Git 源丢失。

若 composer.json 中已有 "repositories": {}（对象结构），命令会安全合并，key 固定为 "packagist"
若 "repositories" 是数组（[]），命令会失败；需先手动编辑，把数组转成对象，再显式添加：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}
根节点必须加 "packagist.org": false（注意：不在 repositories 内部，而在最外层）
已有 composer.lock 的项目，首次换源后建议删掉 vendor/ 和 composer.lock，再重新 composer install，否则易出现 hash 不匹配错误