composer 全局配置实际路径由 composer config --global --list 首行确定，优先使用 $composer_home；修改须用 --global 参数，镜像设置键名为 repo.packagist，注意 https、cafile 与项目 config 覆盖关系。
怎么改 Composer 全局 config 文件位置
Composer 全局配置默认写在 $COMPOSER_HOME/config.json，但很多人改了没生效，其实是没搞清「全局」指哪——它不看你当前项目，也不看 composer.json，而是看 Composer 自己的用户级配置目录。
运行这条命令确认真实路径：composer config --global --list
输出第一行就是实际生效的 config.json 位置。常见坑是：误以为 ~/.composer/config.json 一定对（macOS/Linux）或 %APPDATA%\Composer\config.json（Windows），其实如果设置了 COMPOSER_HOME 环境变量，它会优先用那个路径。
- 改之前先备份原
config.json - 别手动新建
config.json后直接编辑——用composer config --global命令写入更安全，自动处理 JSON 格式和权限 - Windows 下如果用 Git Bash，注意
%APPDATA%在 bash 里不展开，建议切 cmd/PowerShell 执行全局命令
修改镜像源（如阿里云、腾讯云）必须用 --global 参数
只写 composer config repo.packagist composer https://mirrors.aliyun.com/composer/ 是项目级的，不会影响其他项目。要全局生效，必须加 --global：
composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
注意两点：一是 repo.packagist 是固定键名，不是随便起的；二是这个设置会覆盖 packagist.org 官方源，但不会影响私有仓库配置。如果之后想恢复官方源，运行：composer config --global --unset repo.packagist
- 国内用镜像时，别漏掉
https://前缀，http://会被拒绝（Composer 2.2+ 默认禁用非 HTTPS 源） - 某些公司内网镜像需要带认证，这时得用
composer config --global http-basic.repo.example.com username password，否则 install 会卡在 auth 提示 - 改完建议跑一次
composer clear-cache，不然旧缓存可能让镜像切换看起来“没生效”
全局配置被项目 config 覆盖怎么办
项目根目录下的 composer.json 里如果写了 "config" 字段，它会**完全合并覆盖**全局 config，不是“叠加”。比如全局设了 "bin-dir": "bin"，但项目里写了 "bin-dir": "vendor/bin"，那最终生效的就是后者。
这种覆盖是设计如此，不是 bug。所以如果你发现全局 proxy 设置没起作用，先检查项目 composer.json 是否有 config.http-proxy 或 config.gitlab-token 这类冲突项。
- 查项目是否覆盖：运行
composer config --list（不带--global），看输出里哪些值来自 project - 临时绕过项目 config：加
--no-plugins --no-scripts并不能跳过 config 合并，唯一办法是删掉项目composer.json的config段再试 - CI 场景下尤其要注意：Docker 构建时若挂载了本地
composer.json，很可能意外继承了开发机的 config 覆盖逻辑
改完 config 却还是连不上 packagist？检查 cafile 和 disable-tls
最隐蔽的失败原因不是镜像地址写错，而是 TLS 验证失败。Composer 默认校验证书，但某些企业代理或老旧系统证书库过期，会导致 Could not resolve host: packagist.org 或 SSL certificate problem: unable to get local issuer certificate。
临时解决（仅调试用）：composer config --global disable-tls true
但更稳妥的是指定证书路径：composer config --global cafile /path/to/cacert.pem
注意 cafile 必须是 PEM 格式，Windows 用户别直接用系统证书导出的 .cer 文件——得转成 PEM（可用 OpenSSL 或在线工具）。Mac 上通常用 /usr/local/etc/openssl@3/cert.pem（Homebrew 安装的 OpenSSL 3）。
-
disable-tls true是高危操作，别在 CI 或共享环境长期开启 - 改
cafile后务必验证：运行composer diagnose，看 “The openssl extension is loaded” 和 “The cafile setting is correct” 是否都显示 OK - 某些 Linux 发行版（如 CentOS 7）自带 OpenSSL 版本太老，即使指定 cafile 也可能握手失败，这时候只能升级系统或换 Composer 1.x（已停止维护，慎用）
http-proxy 设错，可能让后续所有包安装都静默失败，还看不出报错在哪一层。动手前，先 composer config --global --list 和 composer diagnose 多看两眼。
