执行 composer config -g repo.packagist,若输出为 {"type": "composer", "url": "https://packagist.org"} 或报错“no repo.packagist”,说明未配置镜像,正使用默认源;若返回阿里云或腾讯云 URL,则镜像已生效。

require 指令卡住不是网络问题,而是默认走 packagist.org —— 切换国内镜像后,composer require 通常 1–3 秒完成,无需改项目结构或重装 Composer。
怎么确认当前用的是哪个镜像?
执行 composer config -g repo.packagist。如果输出是 {"url": "https://packagist.org"} 或直接报错“no repo.packagist”,说明没设镜像,正走默认慢通道。
注意:composer config repo.packagist(不加 -g)查的是当前项目的配置,优先级高于全局,但多数项目没配,所以先看全局。
一键切换到阿里云或腾讯云镜像
国内稳定可用的镜像就两个:阿里云(https://mirrors.aliyun.com/composer/)和腾讯云(https://mirrors.cloud.tencent.com/composer/),二者响应速度接近,阿里云 CDN 覆盖略广。
执行以下任一命令即可生效:
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(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 config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
执行后立刻生效,不用重启终端,也不用清缓存(composer clear-cache 可选,但非必需)。
require 还卡?检查这几个地方
镜像切了还慢,大概率是下面某个环节在拖后腿:
-
composer.json里写了"minimum-stability": "dev"或大量"dev-*"版本约束 —— 这会让 Composer 去扫描所有分支,跳过镜像加速逻辑 - 本地
vendor/目录权限异常(尤其 Windows + WSL 混用时),导致写入卡在解压阶段,现象是进度条停在 “Extracting archive…” - 用了
--with-all-dependencies或--update-with-dependencies,触发全图解析,此时镜像只加速元数据下载,不加速依赖求解本身 - PHP 的
openssl.cafile配置错误,导致 HTTPS 握手失败后退回到 HTTP 重试(部分旧版 Composer 会这样),表现为偶发性超时
镜像不是万能的,有些操作它不加速
镜像只加速 composer require、composer install、composer update 中的包元数据(packages.json)和 ZIP 包下载;不加速:
- 依赖版本冲突分析(Solver 阶段)—— 这是纯 CPU 计算,跟网络无关
- 脚本执行(如
post-install-cmd) - 自动加载文件生成(
vendor/autoload.php写入)
所以如果你看到 “Resolving dependencies…” 卡住超过 10 秒,别怪镜像,该精简 composer.json 的版本范围了 —— 比如把 "monolog/monolog": "^2.0 || ^3.0" 改成明确的 "^3.0"。

















