classmap配置后必须执行composer dump-autoload才能生效，否则新增类文件不会被识别；它通过扫描指定路径下.php/.inc文件生成类名到绝对路径的静态映射数组，不支持运行时动态解析或热更新。
classmap 方式不是“写完配置就自动生效”的按需加载机制，它必须显式执行 composer dump-autoload 才能生成映射表，否则新增类文件完全不会被识别。
classmap 配置后必须运行 composer dump-autoload
classmap 不像 PSR-4 那样在运行时动态解析命名空间路径；它是在执行 composer dump-autoload 时，扫描你指定的目录（或文件），把其中所有 .php 和 .inc 文件里声明的类名，逐个写入 vendor/composer/autoload_classmap.php。这个文件本质就是一个大数组：类名 => 绝对路径。
常见错误现象：
- 新增了
src/Utils/Helper.php，但use Utils\Helper报错 Class not found - 修改了类名但没重新 dump，旧类名仍能加载、新类名死活找不到
- 误以为 classmap 支持热更新，结果改完代码就刷新页面，发现没变化
实操建议：
- 配置好
composer.json的"classmap": ["src/", "lib/"]后，**立刻执行composer dump-autoload**（不是install或update） - 开发中频繁增删类？别依赖 classmap，换用 PSR-4；classmap 更适合 SDK、遗留代码、无命名空间的老项目
- 想确认是否生效？直接打开
vendor/composer/autoload_classmap.php，搜索你的类名看是否存在对应映射
classmap 路径写法：相对 composer.json，不支持通配符
classmap 中填的路径是相对于 composer.json 所在目录的，且只接受目录路径或具体文件路径，**不支持 **/*.php 这类 glob 模式**。
使用场景：
- 你想加载一个没有命名空间的工具类：
"classmap": ["app/helpers/GlobalFunctions.php"] - 你有一整个第三方 SDK 目录（比如
thirdparty/sdk/），里面全是class XXX {}，没命名空间也没 PSR 结构 - 你有多个散落的旧类文件，不想重构命名空间，就列成数组：
["legacy/a.php", "legacy/b.php", "old-models/"]
参数差异与坑点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 路径末尾加不加
/都行，但推荐统一加，避免歧义 - 路径不能以
./开头（"./src/"会报错），直接写"src/" - 如果路径指向的是空目录或不存在的路径，
dump-autoload不报错，但也不会生成任何映射 —— 容易误以为“配置成功了”
classmap vs PSR-4：什么时候该用 classmap？
classmap 的核心价值不是“方便”，而是“确定性”和“性能可控”。它不依赖文件命名、不解析命名空间、不拼接路径，就是纯字符串匹配。
适用条件（满足任一即可）：
- 类文件没有命名空间（或命名空间与目录结构完全不一致）
- 需要在生产环境启用
--optimize-autoloader（该选项本质就是强制走 classmap 映射） - 项目中混入了大量非标准 PHP 类（如 Zend Framework 1 风格、CodeIgniter 2.x 风格）
- 你明确知道哪些类一定会被用到，想提前固化路径，规避运行时文件系统查找开销
性能影响：
- 开发阶段：classmap 比 PSR-4 略快（少一次目录拼接+stat），但差异微乎其微
- 生产阶段：
composer install --optimize-autoloader会把 PSR-4 规则也转成 classmap 形式，此时两者底层一致 - 内存占用：classmap 数组随类数量线性增长，上万类时
autoload_classmap.php可达数 MB，APCu 缓存能缓解但无法消除初始化开销
为什么 autoload_classmap.php 里找不到刚加的类？
最常见原因不是配置错，而是扫描遗漏。classmap 扫描逻辑非常机械：
- 只读取
.php和.inc文件 - 只提取文件中用
class、interface、trait声明的顶层结构（不进函数、不进条件块） - 如果类定义在
if (false) { class A {} }里，它不会被收录 - 如果类名含非法字符（如
class A-B {}），PHP 解析失败，也不会收录
排查步骤：
- 确认文件扩展名是
.php（不是.php5或.inc.php） - 运行
composer dump-autoload -v，看输出里有没有扫描到你的文件路径 - 临时把类挪到空文件里单独测试，排除语法干扰
- 检查是否启用了
opcache.enable=0导致autoload_classmap.php没被重载（尤其 Docker 环境）
classmap 的边界很清晰：它不聪明，也不容错。你给它一个路径，它就老实扫；你漏掉一个文件，它就永远不知道那个类存在。这点和 PSR-4 的“约定优于配置”思路截然不同——用 classmap 就得接受它的笨拙与可靠并存。
