如何在Composer安装流程中强制使用中文镜像并忽略官方默认源-composer-PHP中文网

composer换源必须同时满足三条件：全局配置需带type参数（如composer），项目级repositories会完全屏蔽全局镜像，且必须清除缓存并确认执行用户与配置用户一致。

如何在composer安装流程中强制使用中文镜像并忽略官方默认源

composer config -g repo.packagist 命令必须带 type 参数

不写 composer 这个 type 值，配置就等于没设。命令形如 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，其中第二个 composer 是仓库类型，不是命令名。漏掉它，Composer 会静默 fallback 到 https://packagist.org，composer config -g repo.packagist 看起来有输出，但实际请求仍走官方源。

项目级 repositories 会彻底屏蔽全局镜像

只要项目根目录的 composer.json 里存在 repositories 字段（哪怕只有一行 "packagist.org": false），全局配置就完全失效。这不是“优先级低”，而是直接跳过。常见于团队项目或 Laravel 官方脚手架模板，它们自带空 repositories 块。

Discussion Composer

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

下载

验证方式：进项目目录后运行 composer config repo.packagist（不加 -g），如果输出为空或报错，说明项目配置已接管
临时绕过：用 --repository-url 强制当次命令走镜像，例如 composer install --repository-url=https://mirrors.ustc.edu.cn/composer/
永久修复：删掉 composer.json 中整个 repositories 块，或改用 composer config repo.packagist composer https://mirrors.aliyun.com/composer/ 覆盖写入（注意：该命令会重写整个 repositories 对象，私有源需手动保留）

换源后不清理缓存 = 白配

Composer 缓存的是元数据快照（如 p2/monolog/monolog.json），旧缓存里存的仍是官方源地址和 hash。即使镜像已生效，composer update 仍可能因校验失败报 Package not found 或卡在 Loading composer repositories。

必须执行 composer clear-cache，然后确认 ~/.composer/cache/（Linux/macOS）或 %APPDATA%\Composer\Cache\（Windows）下无有效文件
验证是否真走镜像：加 -vvv 参数跑一次安装，看到类似 GET https://mirrors.aliyun.com/composer/p2/monolog/monolog.json 的日志才算成功
别信 composer config -g 输出——它只告诉你字段值，不告诉你 Composer 实际发了什么请求

CI/CD 或宝塔环境里 -g 配置常不生效

全局配置写在 ~/.composer/config.json，但“谁在跑命令”决定读哪个路径。宝塔后台以 www 用户运行，CI 构建容器常用 runner 用户，而你本地终端可能是 root 或普通用户。三者 ~ 指向不同目录，配置互不可见。

解决方案：在 CI 脚本或宝塔部署钩子里，先用目标用户身份执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
更可靠做法：改项目级配置，运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），它会自动写入当前 composer.json 的 repositories 字段，提交 Git 后所有环境一致
检查是否被环境变量覆盖：env | grep COMPOSER_REPO，如有 COMPOSER_REPO_PACKAGIST，需先 unset COMPOSER_REPO_PACKAGIST

换源这事，核心不在“怎么写命令”，而在“谁在读配置、缓存有没有清、项目有没有劫持”。三个地方任一出错，都会让你以为镜像没生效，其实只是没落到真正执行命令的那个上下文里。