Classmap自动加载通过扫描指定目录或文件中的类名并生成静态映射实现，需在composer.json中配置autoload.classmap数组，运行composer dump-autoload生效，支持非PSR规范类但不解析动态定义。
Classmap 自动加载怎么配
Composer 的 classmap 是为没有遵循 PSR-0/PSR-4 规范的类（比如纯函数文件、传统 require_once 风格的类）提供的兜底方案。它不依赖命名空间或文件路径映射，而是直接扫描指定目录下的所有 PHP 文件，把其中声明的类名和文件路径记录进 vendor/composer/autoload_classmap.php。
在 composer.json 中添加如下配置即可启用：
{
"autoload": {
"classmap": [
"lib/",
"src/utils.php",
"legacy/Database.class.php"
]
}
}
注意：classmap 项接受字符串数组，每个元素可以是目录（会递归扫描）、具体文件，甚至带通配符的 glob 路径（如 "legacy/**/*.php"），但需确保 Composer 版本 ≥ 2.2；旧版本只支持目录和完整文件路径。
- 运行
composer dump-autoload才会真正生成或更新 classmap - 修改了
classmap列表后，必须重新 dump，否则新增文件不会被识别 - 如果某文件里定义了多个类，classmap 会为每个类单独记录一条映射
非命名空间类能被自动加载吗
能，而且这正是 classmap 最典型的使用场景。比如你有一堆老项目里的 MyHelper、ConfigLoader 这类无命名空间、文件名也不符合 PSR 标准的类，只要它们被 classmap 扫到，并且文件中用 class MyHelper { ... } 正确定义，Composer 就能在 new MyHelper() 时自动 require 对应文件。
但要注意：这类类不能有同名冲突——classmap 不做命名空间隔离，两个不同文件里都定义 class User，最终只会加载第一个被扫描到的。
- 确保文件中没有语法错误，否则扫描会跳过该文件，且不报错
-
classmap不解析use或namespace，所以即使文件里写了namespace Foo;，只要类本身没加命名空间前缀，就仍按裸类名注册 - 如果类是通过
eval()或动态字符串定义的，classmap 无法识别
classmap 和 PSR-4 混用会不会冲突
不会冲突，但加载优先级有差异。Composer 在自动加载时按顺序尝试各类型：先查 psr-4，再查 psr-0，最后才查 classmap 和 files。这意味着如果一个类同时满足 PSR-4 规则（比如命名空间+路径匹配）和出现在 classmap 中，PSR-4 的路径会优先生效。
常见误操作是：把 PSR-4 已覆盖的目录又加进 classmap，结果导致重复扫描、autoload_classmap.php 变大、dump 速度变慢，却没实际收益。
- 不要把
src/这类已用 PSR-4 管理的目录再塞进classmap - 若部分旧类混在 PSR-4 目录里，建议单独抽离到
legacy/并仅对它启用 classmap - 可以用
composer show -p查看当前生效的 autoload 映射结构
为什么 dump-autoload 后新类还是加载不到
最常见原因是路径没写对，或者文件未被实际扫描到。classmap 不是实时监听，它只在 dump-autoload 时静态快照一次文件结构。
排查步骤：
- 确认
composer.json中classmap路径是相对于composer.json所在目录的相对路径，不是绝对路径 - 执行
composer dump-autoload -v，看输出里有没有类似Searching /path/to/lib for classes，确认目标路径是否被扫描 - 检查
vendor/composer/autoload_classmap.php，搜索你的类名，看是否已写入映射 - 如果类定义在
if块或条件分支里，classmap 无法解析，会被忽略
classmap 的本质是“文件到类名”的静态索引，它不执行代码、不解析逻辑、也不处理动态类名——这点容易被低估。
