Composer只认vendor/name格式的包名而非命名空间，因require操作基于Packagist注册标识符，与PSR-4自动加载路径解耦；需通过Packagist搜索、GitHub检索或composer show反查对应包名，并验证其autoload配置是否正确映射目标命名空间。
Composer 不支持直接通过命名空间 require 包——它只认 vendor/name 形式的包名（即 composer.json 中的 name 字段），不是 PSR-4 命名空间。
为什么不能用命名空间作为 require 目标
命名空间（如 MonologLogger 或 AcmeFooBar）是 PHP 自动加载时的逻辑路径映射，由 autoload 配置决定；而 composer require 操作的是 Packagist 上注册的包标识符，两者完全解耦。试图输入 composer require "monolog/monolog" 是对包名，不是对 Monolog 这个命名空间。
如何找到对应命名空间的包名
常见场景：你看到某文档写 “使用 FooBarBaz 类”，但不知道该装哪个包。这时要反向查：
- 去 Packagist 搜索关键词（如
foo bar、作者名、GitHub 仓库名），再点进结果看其composer.json的name字段和autoload.ps4映射 - 查 GitHub：搜
"Foo\Bar" site:github.com language:json filename:composer.json，定位到定义该命名空间的项目 - 如果已安装部分依赖，运行
composer show列出所有已装包，再结合grep -r "namespace Foo\Bar" vendor/锁定来源
require 后类不可用？检查 autoload 映射是否生效
即使 composer require vendor/name 成功，若类仍报 Class not found，大概率是包本身未正确声明 autoload，或你误判了命名空间归属：
- 打开该包的
vendor/vendor/name/composer.json，确认有类似"autoload": { "psr-4": { "Foo\Bar\": "src/" } } - 执行
composer dump-autoload强制重生成自动加载映射（尤其在开发自己包、改过composer.json后） - 注意大小写：PSR-4 要求命名空间与目录结构严格匹配，
FooBar必须对应src/Foo/Bar/，而非src/foo/bar/
想“按命名空间安装”？只能靠约定或工具辅助
没有原生命令，但可借助外部线索缩小范围：
- 很多组织会统一用
organization/name包名 +OrganizationName命名空间（如symfony/http-kernel→SymfonyComponentHttpKernel），此时可猜composer require symfony/http-kernel - 用
composer search "logger"找关键字，再人工核对命名空间 - 某些 SDK（如 AWS、Stripe）提供官方推荐包名列表，优先查其文档的 “Installation” 章节，而非倒推命名空间
真正容易被忽略的是：同一个命名空间可能跨多个包（比如 DoctrineCommon 分散在 doctrine/common、doctrine/annotations 等），require 错包名不会报错，但类就是不出现——得逐个比对 vendor/*/composer.json 里的 autoload 配置。
