全局配置需明确生效范围：github-oauth等底层参数真能跨项目生效，minimum-stability等仅在无composer.json时生效，autoload等则完全无效；漏加--global参数会误写入项目级配置。
全局配置不是“设一次就万事大吉”，而是要明确哪些值真能跨项目生效、哪些会被项目级配置直接覆盖——不搞清这点，改了也白改。
composer config --global 命令必须带 --global 参数
漏掉 --global（或简写 -g）是最高频失误：命令会默默写进当前项目的 composer.json 的 config 字段，而不是用户级配置文件。
- 正确写法：
composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/ - 错误写法：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（它只改当前项目） - 验证是否写对：执行
composer config --global --list，看到输出里有repo.packagist项才算成功 - Windows 用户注意：
%APPDATA%\Composer\config.json路径需真实存在；PowerShell 中若用变量如$env:APPDATA，得确保没被转义或截断
哪些配置项真正全局生效，哪些只是“看起来像”
全局配置 ≠ 所有配置都起作用。Composer 对不同字段的处理逻辑完全不同：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 真正稳定全局生效的：
github-oauth、http-proxy、cache-dir、process-timeout、secure-http—— 它们控制网络、缓存、超时等底层行为，项目无法覆盖 - 看似全局、实则受限的：
minimum-stability、prefer-stable、platform—— 这些只在当前目录没有composer.json时（比如空目录下运行composer require）才读全局值；一旦项目有composer.json，它们立刻被忽略 - 完全无效的：
autoload、require、scripts—— 这些根本不在全局配置支持范围内，设了也静默丢弃
改完不生效？先查配置路径和覆盖关系
执行 composer config --global --list --verbose 会明确告诉你 Composer 实际读取的是哪个 config.json 文件，以及里面有哪些键。
- 如果输出显示路径是
~/.config/composer/config.json（新版 Linux/macOS 默认），但你一直改的是~/.composer/config.json，那当然没用 - 进任意项目目录后运行
composer config --list（不加--global），对比输出中同名 key 的值：若项目级存在，它一定优先 -
repos.packagist和旧写法repo.packagist是两回事 —— Composer 2.x 推荐用前者，后者可能被忽略或解析为无效结构 - 手动编辑 JSON 后出问题？别猜，直接删掉整个
config.json，用composer config --global重设一遍最省事
Windows 下 cache-dir 和 bin-dir 权限最容易翻车
缓存和全局 bin 目录路径写错，现象不是报错，而是后续所有 composer global require 或 install 静默失败、包装不上、命令找不到。
-
cache-dir必须是绝对路径，且 Composer 进程有完整读写权限；NFS 或 Docker volume 外挂路径常因 UID/GID 不匹配导致Failed to write cache file -
bin-dir设为%APPDATA%\Composer\vendor\bin后，必须把该路径手动加进系统PATH环境变量，否则laravel、phpunit这类全局命令永远找不到 - 设完
bin-dir或cache-dir后，建议立刻执行composer global require laravel/installer并尝试运行laravel --version验证端到端通路 - 别用
sudo或管理员权限运行composer config --global，否则可能写入 root 用户的配置，当前用户完全不可见
最关键的细节往往藏在路径和权限里：全局配置本身很简单，难的是确认 Composer 真正读到了哪一行、写进了哪个文件、又有没有权限用它。
