Composer中文镜像配置的生效范围：局部vs全局-composer-PHP中文网

全局配置仅对当前用户生效，执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/后写入其家目录下的~/.composer/config.json（linux/macos）或%appdata%\composer\config.json（windows），其他用户不受影响；项目级repositories字段优先级恒高于全局配置，存在即屏蔽全局镜像。

composer中文镜像配置的生效范围：局部vs全局

全局配置只影响当前用户，不是系统级

执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后，配置写入的是当前用户的 ~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows），对其他用户完全无效。同一台机器上，root 用户配了镜像，普通用户运行 composer install 仍走官方源——除非他也执行一遍命令。

常见误判场景：

CI 脚本用 sudo composer config -g，结果配置进了 root 的 config.json，而构建进程以 www-data 或 runner 用户运行，读不到
PHPStorm 内置终端默认用 IDE 启动用户权限，但项目实际由 Web 服务器（如 nginx）调用，后者可能用不同用户运行 PHP 进程
Docker 容器里没挂载宿主机的 ~/.composer，容器内始终是默认源

项目级配置优先级永远高于全局

只要项目根目录下 composer.json 里有 "repositories" 字段，无论内容是否为空、是否禁用 packagist.org，repo.packagist 全局配置都会被忽略。这不是“覆盖”，而是 Composer 的硬性优先级规则：项目 > 全局 > 默认。

典型陷阱：

Discussion Composer

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

下载

"repositories": {} 或 "repositories": [] —— 看似空，实则触发仓库机制，全局镜像失效
"repositories": {"packagist.org": false} —— 显式禁用默认源，但没提供替代源，直接报错 Could not find package
执行 composer config repo.packagist ...（漏掉 -g）时，若原 composer.json 已有 "repositories" 对象，新配置会完整替换整个字段，而非合并；私有仓库配置可能意外丢失

临时切换镜像的三种方式及其作用域差异

不改任何配置文件也能强制走指定源，但每种方式生效范围不同：

composer install -r https://mirrors.tuna.tsinghua.edu.cn/composer/：仅本次命令生效，-r 参数优先级最高，连项目级 repositories 都会被绕过
COMPOSER_REPO_PACKAGIST=https://mirrors.cloud.tencent.com/composer/ composer install：环境变量方式，作用于当前 shell 会话，比全局和项目级都高，适合 CI 中灰度测试
composer config --unset repositories && composer clear-cache：手动清空项目级仓库定义，让全局配置重新生效，但必须搭配 clear-cache，否则缓存仍指向旧源

验证是否真在用目标镜像，不能只看配置输出

composer config -g repo.packagist 输出正确 ≠ 实际请求走镜像。缓存、DNS、代理层都可能干扰真实行为。

可靠验证步骤：

加 --no-cache 触发真实网络请求：composer show monolog/monolog --no-cache，观察输出中 Available from 行的域名
开详细日志：composer update -v 2>&1 | grep "Fetching"，看到类似 Fetching https://mirrors.aliyun.com/composer/p2/monolog/monolog.json 才算真正生效
检查 DNS 和 HTTPS 连通性：curl -I https://mirrors.aliyun.com/composer/ 应返回 200 OK；若超时或证书错误，即使配置全对也拉不到包

最易被忽略的是缓存——哪怕配置写对了、网络通了，旧元数据缓存仍会让 Composer 去 packagist.org 拉 packages.json，导致你以为镜像没生效。