composer 全局配置应使用 composer config --global 命令修改，避免手动编辑导致 json 格式错误；需区分 global 与项目级配置，镜像源、oauth token 等环境相关项适合 global，autoload、require 等属项目契约应写在项目 composer.json 中。
怎么改 Composer 的全局 config 文件
Composer 全局配置存在用户目录下的 composer.json 里，不是项目里的那个，也不是系统级的。改它，就是直接编辑这个文件，或者用 composer config 命令操作——后者更安全，能自动校验 JSON 格式。
常见错误是手抖改错了路径、加了中文逗号、多写了逗号导致 JSON 解析失败，下次运行任何 composer 命令都会报错：Could not decode JSON。
- 查当前全局 config 路径：运行
composer config --global --list，第一行就显示home路径，config 文件就在那下面的config.json（注意不是composer.json） - 推荐用命令改，比如设镜像源：
composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果非要手动编辑，务必用纯文本编辑器（别用 Word 或带格式的记事本），保存为 UTF-8 无 BOM 格式
修改 global config 后为什么没生效
改完不生效，八成是因为缓存或作用域混淆。Composer 的 global config 只影响「全局命令」（比如 composer create-project 或全局安装的包），不影响当前项目的依赖安装逻辑——项目里 composer install 优先读项目根目录的 composer.json 和本地 composer.lock。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确认你改的是 global（加了
--global参数），不是当前项目（漏掉参数默认改本地） - 某些配置项（如
fxp-asset-plugin相关设置）在新版 Composer 中已废弃，改了也忽略 - 执行
composer clear-cache，尤其改了镜像源后，旧包信息可能还卡在缓存里 - Windows 用户注意路径分隔符：用
/，别用\，否则repositories里自定义 path 类型仓库会找不到
哪些 config 项该设成 global，哪些不该
global config 适合放「所有项目都一致、且和环境强相关」的设置，比如国内镜像源、GitHub OAuth token、默认语言偏好。但跟项目行为强耦合的，比如 minimum-stability、prefer-stable、插件启用开关，必须写在项目 composer.json 里，否则会导致团队协作时行为不一致。
- 应该 global 的：
github-oauth（避免每次输 token）、repo.packagist（镜像）、notify-on-install（关掉烦人的提示） - 不该 global 的：
autoload、scripts、require、config.platform（PHP 版本模拟）——这些是项目契约的一部分 -
config.process-timeout设太小（如 60）容易在慢网或大包安装时中断；设太大（如 0）又可能卡死，建议 global 设成 300（5 分钟）比较稳妥
用 composer config --global 改配置时的坑
命令行改 config 看似简单，但参数顺序、引号、嵌套结构稍不注意就写错。最典型的是往 repositories 数组里加新源，一不留神就覆盖整个数组而不是追加。
- 添加 packagist 镜像必须用完整 URL，不能只写域名：
https://mirrors.aliyun.com/composer/✅，mirrors.aliyun.com❌ - 删某个 global 配置项：用
--unset，比如composer config --global --unset github-oauth.github.com - 想加自定义仓库？别直接写
composer config --global repositories.foo vcs https://...，这会把整个repositories替换为单个对象。正确做法是先导出：composer config --global --dump repositories，再用--merge或手动编辑 - macOS / Linux 下如果提示
Permission denied，不是权限问题，而是你用了sudo composer ...导致 config 写到了 root 用户目录，普通用户运行时就读不到
global config 是 Composer 的“环境层”，它不参与依赖解析算法，但会影响网络请求、认证、缓存行为。改之前最好先 composer config --global --list 备份当前值，手滑删掉 github-oauth 这种关键项，CI 就可能连不上私有包仓库。
