Composer如何处理命名空间映射关系？命名空间注册规则是什么？

本文共计966个文字，预计阅读时间需要4分钟。

要修改以下内容，使其更加简洁：

为什么写对 "App" 比写对路径还关键

PSR-4 命名空间前缀不是字符串匹配，而是“前缀截取+剩余段路径拼接”的机械过程。Composer 只认以双反斜杠结尾的键，比如 "App" —— JSON 解析后变成 "App"（一个反斜杠），表示“从这个命名空间起点开始截取”。"App" 或 "App\"（三个反斜杠）都会被忽略或降级为 PSR-0 兼容模式（已废弃）。

• "App" ✅：能匹配 AppHttpController，截出 HttpController，再转成 Http/Controller.php
• "App" ❌：不触发 PSR-4，类不会被该规则处理
• "AppHttp" ❌：若同时存在 "App"，则永远不生效——更长前缀被更短前缀截胡
• 大小写敏感："app" 和 "APP" 都无法匹配 namespace AppHttp;

composer dump-autoload 不是可选操作

修改 composer.json 后，vendor/autoload.php 仍读的是旧的 autoload_psr4.php。它不监听配置变更，也不在 require 时动态重载。

• 必须手动运行 composer dump-autoload（开发常用 -o 优化版）
• composer install 或 update 会顺带执行一次，但不能替代明确调用 —— 它们可能跳过 autoload 重生成（尤其加了 --no-dev）
• 验证是否生效：直接打开 vendor/composer/autoload_psr4.php，搜你的前缀键；或运行 composer show --platform 看 autoloader 时间戳

路径值怎么写才不踩坑

PSR-4 的路径值是相对于 composer.json 所在目录的子路径，不是 PHP 当前工作目录，也不是绝对路径。

• 必须不以 / 开头："src/" ✅，"/src/" ❌（会被判为非法绝对路径）
• 推荐以 / 结尾："src/" 明确表示目录；"src" 在磁盘上恰好有同名文件时会静默失败
• 不能包含变量或通配符："../shared/src/" ✅（只要路径真实存在），"./$LIB/src/" ❌（不支持 shell 展开）
• 路径本身不校验是否存在："sr/" 拼错也不会报错，但类一定加载失败

多个包声明相同命名空间时会发生什么

Composer 不支持“叠加”映射。多个包在各自的 composer.json 中都声明 "App" => "src/"，最终只有最后一个被解析的包的映射会保留在 autoload_psr4.php 中。

• 结果：其他包里的 App* 类全部 Class not found，且错误信息不提示冲突
• 查法：grep -r '"psr-4"' vendor/*/composer.json 或 composer show --tree
• 解法：删掉所有包的 psr-4 声明，统一改用 classmap，并确保类文件路径全局不重名
• 注意：classmap 不自动发现新增类，每次加类都要再跑一遍 composer dump-autoload -o

最常被忽略的一点：PSR-4 不扫描文件、不校验类是否存在、不检查命名空间声明是否合法。它只做三件事——读你写的前缀、截取命名空间剩余段、拼路径。错一个字符，就断在第一步。