classmap 必须显式声明在 composer.json 的 autoload 或 autoload-dev 字段下，不支持混入 psr-4 块或顶层配置；它仅静态扫描指定路径，新增类需重新执行 composer dump-autoload -o 才能生效，且启用 --classmap-authoritative 时要求所有类必须存在于 autoload_classmap.php 中，否则直接报错。
classmap 自动加载不是“开箱即用”的智能扫描，它依赖你显式声明或生成映射，否则 composer dump-autoload 不会自动发现新类。
classmap 配置写在哪？必须在 composer.json 的 autoload 或 autoload-dev 下
它不支持在 psr-4 或 psr-0 块里混用；也不能靠 Composer 自己猜路径。常见错误是把 "classmap": ["src/"] 写错层级，比如塞进 require 或顶层字段。
-
autoload里的classmap用于生产环境加载（如框架辅助类、传统 PHP 文件） -
autoload-dev里的classmap仅在开发时生效（如测试工具类、tests/bootstrap.php） - 路径值可以是目录（递归扫描所有
.php）、文件（单个含 class 定义的文件）、甚至空数组[]（合法但无意义）
什么时候该用 classmap？不是所有场景都适合
它适合加载不符合 PSR 标准的旧代码、函数库文件（functions.php）、或少量零散类（比如一个 LegacyHelper.php），但不适合现代项目主结构。
- PSR-4 已覆盖绝大多数类——命名空间与路径严格对应，无需额外配置
-
classmap扫描是静态的：运行composer dump-autoload时生成扁平化数组，新增类必须重新执行该命令 - 若目录下有大量非类文件（如
.gitignore、README.md），Composer 仍会逐个读取再跳过，影响生成速度
如何生成 classmap？composer dump-autoload -o 和 --classmap-authoritative 的区别
默认 composer dump-autoload 只生成 PSR 映射；加 -o（optimize）才会构建 classmap 并合并进 autoload_classmap.php。
-
composer dump-autoload -o：生成优化 autoload 文件，包含所有classmap条目 + PSR 映射，但运行时仍会 fallback 到文件系统检查（除非禁用） -
composer dump-autoload --classmap-authoritative：强制只查 classmap，完全跳过文件系统 autoload 查找——提速明显，但要求所有类都在 classmap 中，漏掉就Class not found - 二者可共用：
composer dump-autoload -o --classmap-authoritative，适合部署后锁定 autoload 行为
常见报错和排查点
最典型的是类存在却报 Class 'XXX' not found，尤其在启用 --classmap-authoritative 后。
- 检查
vendor/composer/autoload_classmap.php是否真包含该类名——打开文件搜类名，没有就说明没被扫描到 - 确认类文件是否以
<?php开头且含class或function定义；纯变量或注释文件不会被收录 - 路径配置用相对路径（相对于
composer.json），不要写./src/或绝对路径；Windows 下反斜杠\会被忽略，统一用正斜杠 - 修改
composer.json后必须重新运行dump-autoload，Git 合并冲突导致composer.json残缺也会让 classmap 失效
classmap 的本质是一次性快照，它的“确定性”带来性能收益，也带来维护责任——删了文件却不重跑 dump-autoload，残留的 classmap 项可能引发静默错误；加了新类却不更新映射，就是直接报错。这点比 PSR-4 更需要意识同步。
