必须用composer config --global修改，手动编辑config.json几乎必然静默失效；确认路径需执行composer config --global --list --verbose，首行即真实加载路径，新版composer只认$composer_home或~/.config/composer/config.json（linux/macos）、%appdata%\composer\config.json（windows）。

必须用 composer config --global 修改，手动编辑 config.json 文件几乎必然出错，且错误不报错、只静默失效。

怎么确认当前生效的全局配置路径

Composer 不会读你“以为”的那个路径。它优先检查 $COMPOSER_HOME 环境变量，其次才是默认位置（Linux/macOS 是 ~/.config/composer/config.json，Windows 是 %APPDATA%\Composer\config.json）。但多个路径可能共存，而 Composer 只认一个。

运行这条命令才能看到真实加载的文件：

composer config --global --list --verbose

输出第一行就是实际读取的 config.json 路径。常见误判包括：

• ~/.composer/config.json 和 ~/.config/composer/config.json 同时存在 → Composer 2.0+ 只读后者，前者被忽略
• 在 Git Bash 中执行 composer config --global → %APPDATA% 不展开，写入失败却不提示
• 设置了 COMPOSER_HOME 但指向空目录或权限不足 → 写入静默失败，config --global --list 输出为空

镜像源设置为什么总不生效

国内用户最常卡在这步：设了阿里云/腾讯云镜像，composer install 还是慢或报错。核心问题不是网络，而是键名和结构写错。

Composer 2.0+ 已废弃 repo.packagist 写法，正确键名是：

composer config --global repos.packagist.org.url https://mirrors.aliyun.com/composer/

注意三点：

• 必须是 repos.packagist.org.url（复数 repos，带 .org，结尾是 .url），拼错一个字符就无效
• 值必须是完整 HTTPS 地址，http:// 会被拒绝（Composer 2.2+ 默认禁用非 HTTPS 源）
• 设完必须运行 composer clear-cache，否则旧缓存里的包索引还在，新镜像根本没机会用上

恢复官方源只需：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

composer config --global --unset repos.packagist.org

哪些配置项必须加 --global 才有效

不是所有 config 键都支持全局作用域。有些字段在项目级写入完全无效，比如认证类配置。

以下必须加 --global 才能起作用：

• github-oauth.github.com：GitHub 令牌，用于绕过 API 限流，项目级设了也忽略
• http-basic.repo.example.com：私有仓库 HTTP 认证，漏掉 --global 就只影响当前项目
• bin-dir：指定 composer global require 安装的可执行文件存放路径，例如 ~/bin，改完记得把该路径加进 $PATH
• store-auths：控制是否将凭证明文保存到全局配置，默认 true；设为 false 可避免密码落盘

漏掉 --global 参数是“改了没生效”问题的主因——它会默默写进当前项目的 composer.json 的 config 字段，而不是全局配置。

项目级 config 会彻底覆盖全局配置

项目根目录下的 composer.json 中如果定义了 "config" 字段，它不是和全局配置“合并”，而是**完全替换**全局同名项。

例如：

• 全局设了 "bin-dir": "~/bin"
• 项目里写了 "bin-dir": "vendor/bin"
• 最终生效的是 vendor/bin，全局设置被丢弃

这种覆盖是设计行为，不是 bug。验证方式很简单：

• 运行 composer config --global --list 查看全局值是否已写入
• 再运行 composer config --list（不加 --global）对比输出，项目级同名 key 一定优先

真正容易被忽略的是：某些配置（如 process-timeout、cache-dir）只在命令执行时读取一次，改完不重启终端或不清 opcache（PHP 8.0+ CLI 默认启用），可能仍沿用旧值。