Composer install报错提示不合法的包名称？命名规范检查方法-composer-PHP中文网

composer包名必须为全小写、含单斜杠、不含中文/大写字母/空格/非法字符，否则直接报“is not a valid package name”错误；合规格式如your-vendor-name/your-package-name，且vendor与package均非空。

composer install报错提示不合法的包名称？命名规范检查方法

包名含中文或大写字母直接触发“is not a valid package name”

Composer 在解析 composer.json 的 name 字段时，会严格校验格式。只要出现中文、大写字母、空格、@、全角符号，或缺少斜杠，就会在 composer validate 或 composer install 阶段报错，错误信息是：is not a valid package name。

这不是警告，是硬性拒绝——哪怕只是 "name": "MyOrg/WeChatSDK"（含大写），也会失败。根本原因不是路径问题，而是 Composer 解析器根本没把这当成一个合法包，后续 autoload 映射、vendor 目录生成全部跳过。

检查所有 name 字段：必须形如 your-vendor-name/your-package-name，全小写、仅含字母、数字、短横线（-）、下划线（_）和点（.）
确认 vendor 和 package 两部分都非空，且中间有且只有一个 /
复制粘贴时特别注意：中文输入法下可能混入全角斜杠 ／ 或不可见字符（可用 cat -A composer.json 查看）

用 composer validate --strict 提前暴露命名问题

composer validate --strict 不检查 JSON 语法，但会强制校验 name 是否符合 Packagist 命名规范。它比 composer install 更早发现问题，且不依赖网络或锁文件。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

运行 composer validate --strict，如果报错包含 name 字段校验失败，说明命名违规
它还会检查 type 拼写（如 library 不能写成 libary）、authors 是否为数组、是否漏掉必填字段等
CI 脚本中建议前置该命令，避免等到 install 阶段才中断构建

vendor 目录出现乱码名（如 weixin-sdk-886b1a）说明源头已污染

如果你发现 vendor/ 下某个目录名是十六进制哈希（如 weixin-sdk-886b1a），这不是路径编码问题，而是 Composer 解析失败后的降级行为：它放弃了按 name 创建目录，转而用源仓库 URL 的 hash 命名。

这种目录下，PSR-4 自动加载映射失效，Class not found 是必然结果
不要试图用 find vendor -name "*微信*" -exec rm -rf {} + 清理——这只会破坏 autoload 映射，让问题更隐蔽
真正要做的，是找到对应包的 composer.json，把 name 改成合规格式（如 myorg/wechat-sdk），再推送到私有仓库并更新 repositories 配置

私有包命名必须与 GitHub/GitLab 组织名一致

Packagist 强制要求 vendor 名与代码托管平台用户名/组织名完全一致。如果你在 GitHub 的组织是 acme-inc，就不能用 acme 或 mycompany 作 vendor 名，否则提交会被拒绝；本地 require 时即使没被占用，也会因校验失败而报 is not a valid package name。