classmap通过扫描指定目录生成类与文件路径的映射表实现自动加载，无需遵循命名规范，适合老项目；在composer.json中配置"autoload":{"classmap":["src/","lib/"]}后运行composer dump-autoload即可生成映射文件；与PSR-4相比，classmap不依赖命名空间，能加载无命名空间的类和非标准命名文件，但性能较低且需手动更新；适用于类名文件名不匹配、遗留代码或第三方库无命名空间的情况，是兼容性方案，新项目推荐使用PSR-4。
Composer 的 classmap 自动加载是一种通过扫描指定目录下的所有 PHP 文件，生成类名与文件路径对应映射表（即 classmap）的方式来实现类自动加载的机制。它不依赖命名规范或命名空间结构，适合用于没有遵循 PSR-4 或 PSR-0 标准的老项目。
classmap 是怎么工作的？
当你在 composer.json 中配置了 classmap 路径后，Composer 会在执行 composer dump-autoload 或 composer install/update 时：
- 扫描你指定的目录和文件
- 解析每个 PHP 文件中的类、接口、trait 声明
- 记录这些类名及其对应的文件路径
- 将这些信息写入 vendor/composer/autoload_classmap.php 文件中
运行时，PHP 遇到未定义的类会触发自动加载函数，Composer 就根据这个 classmap 查找并包含对应的文件。
如何配置 classmap 加载？
在 composer.json 中使用 "classmap" 字段指定需要扫描的目录或文件：
{ "autoload": { "classmap": ["src/", "lib/", "legacy/SomeOldClass.php"] } }
上面的配置会让 Composer 扫描 src/ 和 lib/ 目录下所有 PHP 文件，并单独包含那个旧类文件。
配置完成后，运行：
composer dump-autoload
生成或更新 classmap 映射文件。
classmap vs PSR-4：有什么区别？
- PSR-4 是基于命名空间和文件路径的规则自动推导类位置，性能高，适合现代项目，但要求命名规范
- classmap 不依赖命名规则，能加载任何类，适合遗留代码，但需要全量扫描，生成过程慢，且每次新增类必须重新生成 autoload
- classmap 可以加载没有命名空间的类，而 PSR-4 不行
什么时候该用 classmap？
- 维护老项目，类名和文件名不匹配
- 存在大量非标准命名的类文件
- 需要加载一些全局函数或常量定义（虽然不是类，但可借助 classmap 文件被包含）
- 某些第三方库未提供命名空间支持
基本上就这些。classmap 是一种“兜底”方案，灵活但不够高效。新项目推荐用 PSR-4，老项目过渡阶段可以用 classmap 来保证类能被正确加载。