root-package 是当前执行 Composer 命令所在目录的 composer.json 所定义的项目本身，用于区分自身与依赖包；其 name 不能出现在 require 中，否则触发逻辑冲突错误，且影响 autoload 命名空间解析和 bin 脚本链接。
什么是 root-package
在 Composer 中，root-package 指的就是你当前执行 composer install 或 composer update 命令时，所在目录里的那个 composer.json 所定义的包 —— 也就是项目本身，不是它依赖的任何第三方库。
它不是某个配置项名，而是一个概念性术语，常出现在错误提示、文档或调试输出中（比如 Root package 'myapp' cannot require itself），用来区分“你自己这个项目”和“你 require 进来的其他包”。
为什么 root-package 不能 require 自己
当你在 composer.json 的 require 字段里写上了和自己 name 字段一模一样的包名，Composer 就会报错：Root package cannot require itself。这不是限制，而是逻辑冲突：一个包无法同时是“被安装者”和“被依赖者”。
-
name字段为空或缺失时，Composer 会默认把 root-package 当作root，此时若你在require里写了"root": "*"，也会触发该错误 - 常见诱因：复制粘贴了别人项目的
composer.json，没改name，又保留了原require里的同名条目 - 私有包场景下，如果本地开发时用
path仓库指向自己目录，也需确保name不与require冲突
root-package 的 name 和 version 怎么影响 autoload 和 bin
name 和 version 字段不只用于包注册，还会直接影响本地开发行为：
-
autoload配置中的psr-4或classmap路径，是以 root-package 的name为命名空间前缀解析的（例如"MyApp\\": "src/"要求name是myapp/myapp或匹配的 vendor/name 格式） -
bin字段声明的可执行脚本，只有在 root-package 被composer install后才会软链接到vendor/bin/；若项目只是作为依赖被引入，其bin不生效 -
version字段若为dev-main或dev-develop，且未设minimum-stability，可能导致依赖解析失败或意外降级
如何确认当前是不是 root-package 环境
没有命令能直接输出 “yes/no is root”，但可通过以下方式判断：
- 运行
composer config --list，若输出中包含config.process-timeout等顶层配置，说明你在 root 目录 - 执行
composer show --self，成功返回自身信息即为 root-package；若报错Package not found，说明当前目录没有composer.json或不是 root - 检查
vendor/composer/installed.json：root-package 的条目里会有"type": "project"，而普通依赖是"type": "library"
{
"name": "acme/blog",
"type": "project",
"version": "dev-main",
"autoload": { ... }
}
真正容易被忽略的是：某些 IDE 或 CI 工具会在子目录里运行 Composer 命令（比如 tests/ 下），此时那个 composer.json 可能是测试专用包，但它仍是该路径下的 root-package —— 别默认认为“有 composer.json 就等于主项目”。
