Composer全局镜像配置仅对当前用户生效，写入路径为~/.composer/config.json（Linux/macOS）或%APPDATA%\Composer\config.json（Windows），且必须满足-g、键名repo.packagist、type值composer、URL以/结尾四要素，缺一则静默失效。

全局镜像配置只对当前用户生效

Composer 的 config -g 命令写入的是当前执行用户的 ~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows），不是系统级配置。这意味着：

• 你在终端用 sudo composer config -g，配置会落在 /root/.composer/config.json，普通用户运行 composer install 时完全读不到
• 宝塔面板后台执行命令默认是 www 用户，你用自己账号配的全局镜像对它无效
• Docker 构建中若未显式指定 COMPOSER_HOME 或切换用户，容器内根本不存在该文件，-g 配置形同虚设
• PHPStorm 内置 Composer 若以不同用户启动（比如通过系统服务），也可能读取不到你终端里配的配置

项目级配置会完全覆盖全局镜像

只要当前目录下 composer.json 中存在 repositories 字段，Composer 就会优先使用它，无视全局 repo.packagist 设置。常见陷阱包括：

Discussion Composer

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

下载

• "repositories": {"packagist.org": false} —— 这不是切换镜像，是直接禁用 packagist.org，且没提供替代源，结果就是 Could not find package
• "repositories": []（空数组）—— composer config repo.packagist ... 命令会失败，必须先改成 "repositories": {}
• 已有私有仓库配置，但用 composer config repo.packagist ... 时没加 --merge（实际不支持），它只会覆盖整个 repositories 对象，不是追加

验证是否真在用中文镜像不能只看 config 输出

composer config -g repo.packagist 只告诉你“写了什么”，不等于“正在用什么”。真正生效要看网络请求：

• 执行 composer clear-cache && composer require monolog/monolog -vvv
• 在日志里搜 Downloading，确认出现的是 https://mirrors.aliyun.com/composer/packages.json
• 如果看到 https://packagist.org/packages.json 或 https://repo.packagist.org/packages.json，说明被项目级 repositories 覆盖了
• curl -I https://mirrors.aliyun.com/composer/packages.json 返回 200 OK 才算镜像服务本身可用，否则配置再对也白搭

键名、类型、URL 格式缺一不可

这条命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，四个要素少一个就静默失效：

• -g（或 --global）：漏掉就写进当前项目 composer.json 的 config 字段，对镜像源完全无影响
• repo.packagist：必须是单数 repo，写成 repos.packagist 或 repositories.packagist.org 都会被忽略
• composer：这是 type 值，不是注释；省略后 Composer 2.0+ 会 fallback 到官方源
• https://mirrors.aliyun.com/composer/：末尾 / 不能少，少一个会导致请求路径拼成 /composerpackages.json，直接 404

实际生效的关键不在“有没有配”，而在“配给谁”“被谁读”“有没有被覆盖”。很多人反复执行命令却没效果，问题往往出在用户身份错位或项目级配置干扰，而不是镜像地址本身。