classmap是唯一能加载无命名空间、类名与文件名不一致或定义在.inc文件中的非标准库的方式，但需手动dump-autoload，且易因路径错误、PSR-4截胡或未扫描到而失效。
直接说结论：classmap 是唯一能加载无命名空间、类名与文件名不一致、甚至定义在 .inc 文件里的第三方非标准库的方式；但必须手动执行 composer dump-autoload，且路径写错、被 PSR-4 截胡、或没扫到文件，都会导致 Class not found。
classmap 路径怎么写才真正生效
路径必须是相对于 composer.json 所在目录的**真实存在**的字符串，末尾带 / 表示递归扫描目录，不带则视为单个文件：
-
"lib/"→ 会扫lib/Database.php、lib/utils/Helper.class.php、lib/config.inc -
"legacy/DB_*.php"→ 支持*通配符，但不支持**或正则 -
"src/helpers.php"→ 单文件也合法，适合老式工具包 - 别写
"./lib/"或"lib"（缺斜杠）——Composer 会静默跳过，不报错也不扫描 - Linux 下大小写敏感：
MyDB.php里定义class mydb，部署后就加载失败
为什么 new Database() 还是报错？常见失效场景
不是配置没写，而是被底层机制绕过了：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- PSR-4 优先级永远高于 classmap：
"App\": "src/"已配置，而Database.php恰好放在src/Database.php，哪怕它没命名空间，也会被 PSR-4 “误匹配”并跳过 classmap - 文件有语法错误（比如漏分号、括号不匹配）→ classmap 扫描时直接跳过，不提示，也不进映射表
- 两个文件都定义了
class User→ 后扫描到的覆盖前一个，new User()加载的是哪个，取决于文件遍历顺序，不可控 - 路径写对了但没运行
composer dump-autoload→vendor/composer/autoload_classmap.php里压根没那条记录
怎么验证 classmap 真的扫进去了
别信命令输出“Generating autoload files”，要看生成结果本身：
- 打开
vendor/composer/autoload_classmap.php - 搜索你期望的类名（如
Database），确认键值对存在，且路径中含$vendorDir是正常的 - 如果没找到，回退检查：
composer.json里路径拼写、文件是否真在该路径下、是否被 PSR-4 映射路径覆盖（比如src/和legacy/重叠）、文件是否有语法错误 - 注意：
composer install或update默认不触发 classmap 重建，除非加--optimize-autoloader
files 不是用来加载类的，别塞 UserService.php
files 是每次请求时无条件 require_once，只适合纯函数或常量文件：
- 把
helpers.php改成UserService.php并塞进"files"→ 运行就报Fatal error: Cannot declare class UserService - 正确用法：
"files": ["config/constants.php", "src/functions.php"]，且文件内最好加if (!function_exists('xxx')) { function xxx() {} }防冲突 - 多个
files加载顺序按数组顺序，但不可控依赖——有调用关系时，不如封装成类走 classmap -
files不参与类查找流程，它和自动加载器无关，只是“一启动就全拉进来”
最易被忽略的一点：classmap 不解析任何动态逻辑，不执行代码，不识别 class_alias()，也不管你 eval("class X {}")。它只认静态声明的 class、interface、trait。所有“为什么没加载”的问题，最终都落在“没扫到”或“被 PSR-4 截胡”这两条线上。
