composer config -g 是唯一推荐方式，它自动识别路径、校验json、安全写入并保留原有配置；手动修改文件极易出错，导致命令报错。
全局镜像设置真正生效，只靠 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 这一条命令就够了；其他所有手动改文件、拼 JSON、加斜杠或删缓存的操作，不是多余就是错位。
为什么 composer config -g 是唯一推荐方式
Composer 的全局配置逻辑很明确：它读取 COMPOSER_HOME/config.json（Linux/macOS 是 ~/.composer/config.json，Windows 是 %APPDATA%\Composer\config.json），而 composer config -g 会自动识别路径、校验 JSON 格式、安全写入，并保留已有字段（比如 auth.json 中的 token）。手写配置文件极易因逗号遗漏、缩进错乱或路径错误导致后续所有 composer 命令直接报 file_get_contents(): Failed to open stream。
常见错误现象：
- 执行了
composer config repo.packagist却没加-g或--global→ 写进当前项目，对其他项目完全无效 - 用
sudo composer config -g（Linux/macOS）→ 配置写进了 root 用户的/root/.composer/config.json，普通用户运行时根本读不到 - 字段名写成
repos.packagist或repositories.packagist.org→ Composer 不识别，静默忽略
如何验证镜像是否真正在用
别只看 composer config -g repo.packagist 的输出，那只是“你写了什么”；要看 Composer 实际请求了哪个域名。最可靠的方法是加 -vvv 跑一次真实操作：
composer clear-cache && composer require monolog/monolog -vvv
在日志里搜索 Downloading，确认出现的是：
Downloading https://mirrors.aliyun.com/composer/packages.json
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
而不是 https://packagist.org/packages.json 或 https://repo.packagist.org/packages.json。如果看到后者，说明全局配置被项目级 repositories 覆盖了——此时要检查当前目录下 composer.json 是否有 "repositories" 字段。
项目级 repositories 覆盖全局时怎么处理
只要项目根目录存在 composer.json 且里面定义了 "repositories"，Composer 就会完全忽略全局的 repo.packagist 设置。这不是 bug，是设计行为。
解决方式取决于场景：
- 想统一团队行为 → 直接删掉项目
composer.json中的"repositories"字段（除非确需私仓） - 需要同时用私仓 + 镜像 → 把私仓放在
repositories数组最前面，并显式禁用官方源："packagist": false - CI 环境临时绕过项目配置 → 用
COMPOSER=/dev/null composer install（仅适合调试），或更稳妥地建一个最小化ci-composer.json，只保留必要字段
哪些配置项能全局生效，哪些不能碰
全局配置不是“设了就自动穿透所有项目”。真正稳定起效的，是那些和「运行时行为」强相关的基础项：
-
repo.packagist：换镜像源（如阿里云），新项目初始化时兜底使用 -
github-oauth.github.com：存 token，避免 GitHub API 限流 -
cache-dir：指定缓存目录（比如 SSD 分区），影响所有项目的下载解压速度 -
process-timeout：调高超时（如设为 600），防止大包卡死
以下这些不要设成全局：
-
minimum-stability、prefer-stable：它们属于项目契约，全局设了在空目录下composer require时可能生效，但一旦项目有composer.json就立即被覆盖 -
autoload、require、scripts：全局配置里写这些完全无效，Composer 会忽略
特别注意：COMPOSER_HOME 环境变量决定全局文件位置，但它本身不是配置项；设错路径会导致所有全局配置“找不到家”，而且必须是绝对路径，不能含 ~、$HOME 或 %USERPROFILE%。
