classmap是composer生成的类名到文件路径的静态映射数组，用于绕过psr-4/psr-0推导、提升加载性能，适用于遗留无命名空间类或需极致性能的稳定场景；它不会自动更新，必须手动执行composer dump-autoload。
Composer 的 classmap 不会自动更新，除非你主动运行 dump-autoload 或安装/更新包——它不是实时监听文件变化的机制。
classmap 是什么，什么时候该用它
classmap 是 Composer 生成的一个扁平化类名到文件路径的 PHP 数组，用于绕过 PSR-4/PSR-0 的目录推导逻辑，直接定位类文件。它适合以下场景：
- 遗留项目中大量无命名空间、不遵循标准目录结构的类（比如
functions.php、DB.class.php） - 需要极致加载性能且类数量稳定（避免每次请求都做路径扫描）
- 某些 CLI 工具或静态分析工具依赖完整类索引
但注意：classmap 不支持动态新增类——新添一个 Helper.php，不重跑命令就不会被加载。
怎么生成和更新 classmap
靠 composer dump-autoload 命令触发，关键在参数：
- 默认只处理
autoload和autoload-dev里声明的classmap路径，不会扫全项目 - 加
-o（--optimize）会强制合并所有自动加载规则为一个classmap，包括 PSR-4 映射——这会让 autoloader 变快，但开发时改了类名或路径要手动重跑 - 加
--classmap-authoritative会让 Composer 完全信任 classmap，遇到未登记的类直接抛Class not found，不再 fallback 到文件系统扫描
示例：把 lib/ 和 src/legacy/ 加进 classmap
{ "autoload": { "classmap": ["lib/", "src/legacy/"] } }之后必须执行：composer dump-autoload
常见错误：类明明写了却报 Class not found
绝大多数是 classmap 没刷新，或路径配置错。典型现象：
- 新增类后
php -r 'new MyClass();'报错，但删掉vendor/autoload.php改用 require_once 却能跑——说明 classmap 没包含它 - 路径用了相对路径如
"./lib"，而 Composer 解析时以composer.json所在目录为基准，写成lib/就行 - windows 下路径分隔符混用（
libutils），应统一用正斜杠lib/utils - classmap 路径指向的是空目录或不存在的路径，Composer 默认静默跳过，不会报错
classmap 和 PSR-4 共存时的优先级
Composer 不按顺序“优先匹配”，而是把所有规则合并进同一个 autoload 函数。但行为上：
- PSR-4 规则先尝试按命名空间找目录，找不到才 fallback 到 classmap 查表
- classmap 里如果登记了
MyClass，而 PSR-4 也映射了同名类，最终加载的是 classmap 指向的文件（因为它是精确匹配，PSR-4 是路径拼接） - 用
--classmap-authoritative后，PSR-4 fallback 彻底失效，没进 classmap 就是找不到
所以别在同一个项目里对同一类既写 PSR-4 映射又塞进 classmap——容易自己绕晕，也增加维护成本。
classmap 的核心就两点：它不自动，得手动生成；它很实在，登记了才认，漏了就真找不到。很多人卡住，其实就差一行 composer dump-autoload。