Composer 的 config 字段必须置于 composer.json 根级，仅支持官方定义的键名，不支持嵌套自定义对象，修改后需运行 composer install/update 生效；它控制本地行为与解析逻辑，非教程型配置，误放位置或滥用将导致无效。
Composer 的 config 字段不是“教程型配置”，它只在 composer.json 里生效，且多数键值直接控制本地行为或包解析逻辑——写错位置（比如放进了 scripts 或全局 config）就完全不生效。
config 字段必须放在 composer.json 根级
很多人把 config 塞进 require、scripts 甚至 extra 里，结果改了等于没改。它只能是 composer.json 最外层的一个键：
{
"name": "my/app",
"type": "project",
"config": {
"sort-packages": true,
"platform-check": false
}
}
-
config不支持嵌套对象（比如"config": { "github-oauth": { "github.com": "xxx" } }是合法的，但"config": { "foo": { "bar": true } }就会被忽略） - 所有键名必须是 Composer 官方文档明确定义的，自定义字段不会报错，但也不会起作用
- 修改后要运行
composer install或composer update才会应用（比如process-timeout影响的是后续命令执行，不是 config 读取本身）
常用 config 键值和典型误用场景
以下键值高频出现，但容易因理解偏差导致行为异常：
-
sort-packages：设为true后，composer require会自动按字母序重排require列表 —— 但它不影响已存在的依赖顺序，也不影响composer update的解析逻辑 -
platform：用于伪造 PHP 或扩展版本，例如"platform": {"php": "8.1.0", "ext-gd": "1.0"}。注意：它只影响当前项目依赖解析，**不改变实际运行环境**；若本地 PHP 是 8.3，但platform锁成 8.1，可能装上本不该兼容的旧版包 -
fxp-asset相关配置（如no-api）已废弃，Composer 2+ 内置 GitHub/GitLab 支持，继续写只会被忽略 -
preferred-install：可设为"dist"或"source"，但对私有仓库影响大——如果私有 Git 仓库没打 tag，"dist"可能 fallback 失败，反而卡住安装
全局 config 和项目 config 的优先级冲突
运行 composer config --global foo bar 会写入 ~/.composer/config.json，而项目级 composer.json 中的 config 字段会覆盖同名全局配置 —— 但仅限于部分字段：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 覆盖生效的：如
sort-packages、process-timeout、notify-on-install - 不覆盖、只合并的：如
github-oauth、http-basic，项目 config 会和全局 config 合并使用 - 完全不读项目 config 的：如
cache-dir、data-dir—— 这些只能通过全局 config 或环境变量COMPOSER_CACHE_DIR控制
验证当前生效值，用 composer config --list（显示全部）或 composer config platform.php（查单个），别靠猜。
config 字段无法解决的常见问题
有些需求看起来该配 config，其实走错了路：
- 想让
composer install跳过 dev 依赖？该用--no-dev参数，不是配config - 想换镜像源？该改
repositories字段，或用composer config repo.packagist composer https://mirrors.aliyun.com/composer/，而不是在config里硬写 URL - 想限制最低稳定性？该用
minimum-stability+prefer-stable，这两个是独立字段，不在config下
config 字段本质是“行为微调开关”，不是依赖策略或源管理的入口。越想用它兜底，越容易绕进死胡同。
