classmap 是通过逐行读取 PHP 文件内容、用正则提取顶层 class/interface/trait 声明来扫描的，不解析 namespace 或 use；扫描范围严格由 composer.json 中 "autoload": {"classmap": [...]} 的路径配置决定，支持目录（如 "src/"）、文件（如 "lib/Helper.php"）和 glob（如 "legacy/DB_*.php"），但路径必须真实存在。
classmap 是怎么被 dump-autoload 扫描出来的
它不是靠文件名或目录结构“猜”类，而是**逐行读取 PHP 文件内容，用正则提取顶层 class、interface、trait 声明**。不解析 namespace 语句嵌套，也不管 use 或 require——只看文件里有没有 class Foo 这种字面量。
扫描范围完全由 composer.json 中 "autoload": { "classmap": [...] } 的值决定：
- 写
"src/"（末尾带/）→ 递归扫描整个目录及其子目录 - 写
"lib/Helper.php"（无/）→ 只处理这个具体文件 - 写
"legacy/DB_*.php"→ 支持 glob，但不支持**或*通配符 - 路径必须真实存在，否则
dump-autoload会 warning 但继续执行
为什么加了 classmap 配置却没生成 autoload_classmap.php 条目
常见原因是：你只改了 composer.json，但没运行 composer dump-autoload；或者路径写错了，比如把 "lib/" 写成 "lib"（缺斜杠），Composer 会把它当作文本字符串读入，报 Could not scan for classes 而不是 fatal error。
autoload_classmap.php 不是“每次请求都生成”，它只是个静态数组文件，内容形如：
return [
'SomeLegacyClass' => $vendorDir . '/myproject/lib/old.php',
'ApiClient' => $vendorDir . '/myproject/src/Api/Client.php',
];
这个文件只有在以下任一动作发生时才会重写：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 手动执行
composer dump-autoload - 执行
composer install或composer update - 加了
-o参数（composer dump-autoload -o）且项目有 PSR-4 配置——此时会把 PSR-4 映射也转成 classmap 条目
classmap 和 PSR-4 共存时谁先加载
PSR-4 优先级高于 classmap。Composer 加载器按注册顺序查找：psr-4 → psr-0 → classmap → files。一旦 PSR-4 规则匹配成功，就不会再进 classmap 查。
这意味着：
- 如果你在
"App\": ["src/"]下定义了AppUserController，又在classmap里也声明了同名类，PSR-4 的那个会生效 - classmap 只作为后备机制，适合处理没有命名空间的老代码、散列工具类、或不符合 PSR-4 命名规范的文件
- 重复类名（不同路径）会被后加载的覆盖——classmap 里后扫描到的同名类会覆盖前面的映射
dump-autoload -o 真的更快吗？什么情况下反而拖慢启动
加 -o（--optimize）确实跳过了 PSR-4 的路径拼接逻辑，直接查 classmap 数组，对大量类的项目有微弱性能提升。但它本质是把所有 PSR-4 类也“强行”索引进 classmap，导致 autoload_classmap.php 体积变大、生成时间变长。
容易被忽略的代价：
- 开发中频繁增删类或改名？
-o后必须每次手动dump-autoload -o，否则新类永远不进映射 - CI/CD 构建时用了
-o，但本地没用 → 本地跑不通、线上能跑，排查困难 - 如果项目本身 classmap 配置为空，且没开 PSR-4，
-o不会生成任何 classmap 条目，命令看似成功，实际无效
真正影响加载速度的，往往不是 classmap 是否启用，而是 require 'vendor/autoload.php' 是否放在脚本最开头、以及 OPCache 是否启用——这两点比 -o 更关键，也更容易被漏掉。
