Composer全局镜像仅对当前用户生效，写入~/.composer/config.json（Linux/macOS）或%APPDATA%\Composer\config.json（Windows），不作用于系统级或Docker容器内未指定用户的场景；--system参数已废弃，必须用--global；项目级repositories字段会覆盖全局配置。
Composer 全局镜像配置生效范围到底在哪
全局镜像配置只对当前用户生效，不作用于系统级或 Docker 容器内未指定用户的场景。它写入的是 ~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows），不是 /etc/composer/config.json 或项目根目录的 composer.json。这意味着：同一台机器上不同用户需各自配置；CI/CD 环境或容器中若以 root 或其他用户运行，必须显式切换用户或改用环境变量方式。
修改 composer config 时该用 --global 还是 --system
--system 在 Composer 2.2+ 已被废弃，强行使用会报错 Invalid argument supplied: --system is not supported。唯一可靠方式是 composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/。注意三点：
- 必须带
--global，否则只改当前项目配置 - URL 必须以
https://开头，http://会被拒绝（Composer 2.0+ 默认禁用非 HTTPS 源） - 阿里云、腾讯云、华为云等镜像站域名可能变更，例如清华源已从
https://packagist.phpcomposer.com切换为https://packagist.mirrors.ustc.edu.cn，旧地址会返回 404
CI/CD 或 Docker 中如何确保镜像配置生效
在无交互环境（如 GitHub Actions、GitLab CI）中，composer config --global 可能因 HOME 目录未正确设置而写入失败。更稳妥的做法是直接写入配置文件或通过环境变量控制：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
mkdir -p ~/.composer && echo '{"repositories":{"packagist.org":{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}}}' > ~/.composer/config.json - 设环境变量
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/，Composer 2.2+ 会自动识别并覆盖默认源 - Dockerfile 中避免用
RUN composer config --global ...，改用COPY config.json /root/.composer/config.json（对应 root 用户）或USER appuser后再 COPY 到对应家目录
镜像配置后仍走官方源？检查这三处
常见原因不是配置没生效，而是被更高优先级规则覆盖：
- 项目根目录存在
composer.json，且里面定义了"repositories"字段——它会完全屏蔽全局镜像 - 运行命令时加了
--repository-url=...参数，该参数优先级高于全局配置 - 本地有
~/.composer/auth.json且含私有仓库配置，某些镜像站（如阿里云）对含 auth 的请求会 fallback 到 packagist.org，导致部分包下载缓慢或失败
验证是否真走镜像：执行 composer diagnose，看输出中 Repo.packagist.org 的 URL 是否为你配置的镜像地址；再跑一次 composer show -p | head -n 3，观察网络请求日志（可加 -vvv）里实际访问的域名。
