最稳方案是执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/,因该命令自动写入全局配置、避免手动编辑json出错、强制所有项目走镜像且优先级高于项目级配置。

不用改配置文件,也不用记镜像地址——composer config -g repo.packagist 一条命令就能永久切换国内镜像。
为什么 composer config -g repo.packagist 是最稳的方案
很多人手动改 ~/.composer/config.json,结果权限出错、JSON 格式崩了、或被后续 composer global update 覆盖。用 composer config -g 直接写入全局配置,Composer 自己维护格式和合并逻辑,不碰原始文件结构。
-
-g表示全局生效(对所有项目起作用) -
repo.packagist是 Composer 官方支持的镜像配置键名,不是随便起的别名 - 设置后,
composer install和composer create-project都自动走镜像,无需额外参数
主流镜像怎么选?命令直接抄
清华、阿里、腾讯三家里,清华镜像同步最勤、HTTPS 稳定性最好;阿里偶尔有 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 https://packagist.phpcomposer.com # 已停用,别用
composer config -g repo.packagist https://packagist.mirrors.ustc.edu.cn # 中科大(推荐)
composer config -g repo.packagist https://mirrors.aliyun.com/composer/ # 阿里云
composer config -g repo.packagist https://mirrors.cloud.tencent.com/composer/ # 腾讯云
注意:https://packagist.phpcomposer.com 已下线,执行会报错 Connection refused,别再复制过时教程里的地址。
换回官方源?删掉配置就行
镜像用久了想验证是否真有问题,或者团队要求必须走官方源,不需要手动编辑 JSON 文件:
- 执行
composer config -g --unset repo.packagist即可清除镜像设置 - 执行
composer config -g repo.packagist可查看当前值,空输出说明已恢复默认 - 如果误设成无效地址,
composer diagnose会明确提示Repo packagist.org is not valid
真正麻烦的不是命令本身,而是有人把镜像 URL 拼错、漏掉末尾斜杠、或混用 HTTP/HTTPS —— 这些错误不会报语法错,但会导致 composer install 卡在 “Loading composer repositories” 十几分钟不动。确认 URL 之前,先浏览器里打开试试能不能看到 JSON 响应体。










