type 字段必须显式声明于 composer.json 根对象，值为官方认可的大小写敏感字符串（如 library、project、composer-plugin），不可为空或数组；library 适用于可被其他项目 require 的包，需配置 autoload；project 适用于通过 create-project 初始化的独立应用；composer-plugin 还需实现 plugininterface、通过 extra.plugin-class 指定类路径且该类在 autoload 范围内；框架专用 type（如 wordpress-plugin）依赖 composer/installers 包支持，否则无效；自定义 type 同理需配套 installer；type 错误虽不阻断 install，但会导致插件不加载、自动加载冲突、packagist 展示异常等连锁问题。
type 字段必须显式写在 composer.json 根对象里，值只能是 Composer 官方认可的字符串（如 library、project、composer-plugin），大小写敏感，不能是空值或数组——写错或漏写会导致工具链行为异常，比如插件不加载、元包被当成普通库安装。
怎么判断该设成 library 还是 project
核心看这个包是否会被其他项目 require：能被 require 就是 library；只打算用 create-project 初始化、自带 public/index.php 或完整启动逻辑的，就是 project。
-
library包必须有autoload配置（如 PSR-4 映射），否则其他项目引入后类找不到 -
project包若误设为library，可能被意外作为依赖装进别人 vendor 里，造成路径混乱或自动加载冲突 - Packagist 页面上，
project类型不会出现在 “Require” 建议列表中，而library会
composer-plugin 必须满足哪些硬性条件
光写 "type": "composer-plugin" 不够，Composer 只会在满足全部条件时才真正加载它：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 包里必须存在一个实现
ComposerPluginPluginInterface的类 -
composer.json中需通过extra.plugin-class指定该类的完整命名空间（如"extra": {"plugin-class": "Vendor\Plugin\MyPlugin"}） - 该类必须放在
autoload覆盖路径下，否则 Composer 找不到、不实例化 - 如果没实现接口或类路径不对，Composer 启动时会静默跳过，不会报错，但插件功能完全失效
框架专用类型（如 wordpress-plugin）为什么有时不生效
这类 type 值本身没有魔法，它们只是“信号”，真正起作用的是第三方安装器（如 composer/installers）。没有它，Composer 一律按 library 处理。
- 必须在根项目的
require中声明"composer/installers": "^2.0"（注意版本兼容性） -
installers包会读取type值，把wordpress-plugin类型的包装到wp-content/plugins/，而非vendor/ - 如果项目里没装
installers，或者装了但版本太旧（如 1.x），type值就只是个注释 - 自定义 type（如
my-framework-bundle）同理，必须配套开发并注册自己的 installer
最常被忽略的一点：type 不影响 composer install 是否成功，但它决定了后续所有工具链行为——包括 IDE 自动补全识别、CI 环境构建策略、Packagist 展示逻辑，甚至某些部署脚本的路径判断。设错 type，问题往往延迟暴露，排查成本远高于初始化时多敲几个字符。
