Composer一键切换国内镜像工具介绍与使用教程-composer-PHP中文网

composer config -g 命令切换镜像必须严格满足三要素：键名 repo.packagist（单数）、type 值 composer、url 以 / 结尾的 https 地址，缺一则静默回退官方源且不报错。

composer一键切换国内镜像工具介绍与使用教程

直接用 composer config -g 命令就能切换，根本不需要额外工具——所谓“一键脚本”反而容易写坏配置、破坏 JSON 格式、跨平台不兼容。

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

不是网络慢，是命令漏了关键三要素中的任意一个，Composer 就会静默 fallback 到官方源，且完全不报错：

-g 没加 → 只改当前项目 composer.json，换目录就失效
键名写成 repos.packagist 或 packagist.org → Composer 2.x 硬编码只认 repo.packagist（单数、全小写、无 s）
URL 少了末尾 / → 请求路径拼成 /composerpackages.json 直接 404
漏掉 composer 这个 type 值 → 命令变成 composer config -g repo.packagist https://mirrors.aliyun.com/composer/，实际没设 type，等于白配

正确切换阿里云 / 腾讯云 / 华为云镜像的命令

复制粘贴执行即可，注意空格、斜杠和引号（Linux/macOS 不需要引号，Windows CMD 需双引号包裹 URL）：

阿里云：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
腾讯云：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
华为云：composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/
恢复官方源：composer config -g --unset repo.packagist

清华旧镜像 https://packagist.phpcomposer.com 已下线，继续用会报 Could not resolve host；中科大镜像 https://packagist.mirrors.ustc.edu.cn/ 同步延迟略高，日常开发优先选阿里云或腾讯云。

Discussion Composer

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

下载

切完必须跑 `composer clear-cache`

否则本地缓存仍指向旧源，composer install 看似走新地址，实则元数据还是从 packagist.org 加载，导致速度没变、甚至报 hash 不一致：

缓存不清理 → composer install 可能卡在 Loading composer repositories，但日志里看不到真实请求地址
验证是否真生效：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果输出为空、null 或报错，说明配置根本没写进去

项目级配置比全局更可靠

尤其在 CI、宝塔、多用户环境或团队协作中，全局配置容易被覆盖或权限错位（比如 sudo -u www composer install 实际读的是 www 用户的 ~/.composer/config.json）：

进项目根目录后执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加 -g）
它会自动合并到 composer.json 的 "repositories" 字段，生成标准结构，不破坏已有私有源
前提：原 "repositories" 是对象（如 {"packagist": {}}），不是数组；如果是数组，命令会失败，需先手动转格式
提交 composer.json 到 Git，新人拉代码后行为一致，composer.lock hash 也稳定