composer 提示 "Root package ‘...’ cannot be licensed as it is not a library"-composer-PHP中文网

composer 提示 "Root package ‘...’ cannot be licensed as it is not a library"

穿越時空

发布： 2025-12-12 19:55:02

原创

820人浏览过

答案是调整composer.json中的type字段：若为应用项目应设为"project"或删除该字段，若为可复用库则确保正确发布。

$composer 提示 \$

当你在使用 Composer 时遇到提示：

Root package '...' cannot be licensed as it is not a library

这通常是因为你在项目的 composer.json 文件中设置了 type: "library"，但当前项目是应用型项目（如框架项目、网站项目），而不是一个可复用的库（library）。

问题原因

Composer 对 “root package”（即你当前项目的主包）有一些限制：

如果你的项目是应用型项目（比如 Laravel、Symfony 应用），它应该是 type: "project" 或不设置 type（默认为 project）。
只有当你开发的是一个可以被别人通过 Composer 安装的公共库或组件时，才应设为 "type": "library"。
当你将一个 root package 设为 library 类型时，Composer 会警告你，因为 root package 不应该被当作可分发的库来“授权”或“发布”。

如何解决

根据你的项目类型进行调整：

情况一：你是开发一个应用（如网站、后端服务）

你应该将 type 设置为 project 或直接删除 type 字段（推荐）：

Picit AI

免费AI图片编辑器、滤镜与设计工具

195

查看详情

{
    "name": "your-vendor/your-app",
    "description": "A web application",
    "type": "project",  // 或者干脆去掉这一行
    "require": {
        "php": "^8.1",
        "laravel/framework": "^10.0"
    }
}

登录后复制

这样 Composer 就不会报 licensing 警告了。