extra字段是composer中唯一被广泛称为“额外数据容器”的顶层json对象，仅作为插件或脚本读取的元数据扩展区，本身不触发任何行为，须配合具体工具约定的键名才生效。
Composer 没有叫“辅助字段”的官方概念——你看到的 extra 字段，就是实际唯一被广泛称为“额外数据容器”的字段；其他如 name、description 等属于元数据，不参与依赖解析，也不算“辅助”。
extra 字段不是配置项，是插件约定的数据通道
extra 本身不触发任何行为，Composer 只保留它、透传它。它起作用的前提是：有插件或脚本主动读取并解释其中的内容。
- 常见误用：把
extra当成通用配置入口，比如写"extra": {"timeout": 30}但没插件读它 → 完全无效 - 必须配合具体工具约定的 key 才有意义，例如 Laravel 读
extra.laravel.dont-discover，Symfony Flex 读extra.symfony.require - 字段位置固定在
composer.json顶层，类型必须是 JSON object，不能是 string 或 array - 键名（如
laravel、my-app）无官方限制，但需与下游工具文档对齐，拼错就等于没写
哪些字段属于元数据（metadata），它们影响 Packagist 展示而非运行时
元数据字段包括 name、description、type、keywords、homepage、license、authors、support。它们不控制安装逻辑，只决定包怎么被发现和分类。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
description是必填项，且长度 ≤120 字符，composer validate会直接报错 -
name必须符合vendor/name格式，且满足正则^[a-z0-9]([_.-]?[a-z0-9]+)*/[a-z0-9](([_.]|-{1,2})?[a-z0-9]+)*$，否则 Packagist 拒绝收录 -
type影响安装路径：值为library（默认）进vendor/，project表示应用主包，metapackage不写文件只触发依赖安装 - 这些字段对本地开发无运行时影响，但缺失或格式错误会导致包无法发布或搜索不可见
scripts 和自定义 PHP 脚本怎么安全读取 extra 数据
如果你在 composer.json 的 scripts 里写了 PHP 类方法，想拿到 extra 内容，得确保调用上下文正确——不是靠 $argv，而是通过 Composer 的事件对象。
- 脚本签名必须接收
Composer\Script\Event实例，例如：public static function postInstall(\Composer\Script\Event $event) - 读取方式为：
$event->getComposer()->getPackage()->getExtra()，返回关联数组 - 若脚本被 CLI 直接调用（如
php script.php），getExtra()会返回空数组或报错，因为没有 Composer 运行时上下文 - 推荐加判空：
if (isset($extra['my-app']['env'])) { ... }，避免未定义 key 导致 Notice
真正容易被忽略的是：extra 字段的语义完全由消费者定义，没有 schema、没有校验、也没有 fallback。写进去的东西，要么有人读，要么就是废数据——它不像 require 那样有强制约束力，也不像 autoload 那样有明确执行路径。用之前，先确认你的框架或插件文档里是否明确定义了你要写的那个 key。
