classmap 是 Composer 通过扫描指定路径中 PHP 文件提取类名并映射到文件路径的静态数组，生成于 composer dump-autoload 时，运行时直接键值查找并 require 文件，适用于非 PSR 规范的老代码。
Composer 的 classmap 自动加载机制，本质是“提前扫描 + 静态映射”，不依赖文件命名或目录结构，专为非 PSR-0/PSR-4 规范的老代码、工具类、函数库等设计。
classmap 是怎么生成的？
执行 composer dump-autoload（或安装/更新时）时，Composer 会递归扫描 composer.json 中 "autoload": {"classmap": [...]} 指定的路径（支持目录或具体文件），逐个解析 PHP 文件，提取其中声明的类、接口、trait 名称，并记录其所在文件的相对路径。最终生成一个扁平的 PHP 数组，形如：
[ 'SomeLegacyClass' => $vendorDir . '/mylib/lib/legacy.php', 'HelperUtils' => $vendorDir . '/mylib/src/utils.php', ]
这个数组被写入 vendor/composer/autoload_classmap.php，作为运行时的查找依据。
运行时如何触发加载？
当代码中首次使用一个尚未定义的类（如 new SomeLegacyClass()）时，PHP 会触发自动加载机制。Composer 注册的 ClassLoader::loadClass() 方法会被调用，它会：
- 先查 PSR-4/PSR-0 映射表（没命中则跳过）
- 再查
classmap数组 —— 直接用类名作键尝试获取文件路径 - 如果找到，就
require对应文件；没找到则继续委托给其他加载器或报错
哪些情况适合用 classmap？
classmap 不挑结构，只认实际声明的类名，因此特别适合：
- 单文件含多个类（比如
functions.php里混着 class、interface 和全局函数） - 类名与文件名/路径完全不对应（如
DB.php里定义了DatabaseConnection） - 没有命名空间的老项目、WordPress 插件、CodeIgniter 辅助类等
- 需要确保某些类绝对被加载（哪怕没被直接 new，比如通过反射或字符串调用）—— classmap 是“声明即注册”，不依赖使用时机
注意点和常见误区
classmap 是静态快照，不是实时监听：
- 新增类后必须重新运行
composer dump-autoload，否则不会生效 - 扫描过程会跳过语法错误的 PHP 文件（但不会报错提醒，容易遗漏）
- 同一个类名在多个文件中定义会导致后扫描到的覆盖前一个 —— Composer 不校验冲突，需自行避免
- 不支持条件加载（比如基于 PHP 版本 include 不同文件），classmap 只记录“这个类在哪”
基本上就这些。classmap 不复杂但容易忽略它的静态特性 —— 它不是魔法，只是把“找文件”这步提前算好，换来了兼容性和确定性。
