classmap模式下类名大小写不一致会导致加载失败，因其仅原样映射类名到路径，不进行命名空间推导或纠错；需确保类声明、文件名、autoload_classmap.php中键名三者完全一致且符合psr-4约定。
classmap 模式下类名大小写不一致会直接导致加载失败
Composer 的 classmap 模式不做任何命名空间推导或路径纠错，它只做一件事：把你在 composer.json 里写的类名字符串，原样映射到你指定的文件路径。一旦类名声明（比如 class MyHelper）和 autoload_classmap.php 中登记的键名（如 "MyHelper"）大小写不一致，PHP 就根本不会触发自动加载——连报错都省了，直接 Class not found。
怎么确认是不是 classmap 大小写问题
别猜，直接看生成的映射表：
- 运行
composer dump-autoload -v，注意输出里是否出现类似Scanning xxx/Helper.php for classes，但没提你那个类名 - 打开
vendor/composer/autoload_classmap.php，搜索你的类名（比如MyHelper），看键名是否完全一致（"MyHelper"✅，"myhelper"❌，"Myhelper"❌） - 手动检查该文件顶部的
class声明：如果文件里写的是class myhelper，那无论你命名空间怎么写、路径怎么放，classmap都只会登记小写键
classmap 扫描时大小写敏感的几个关键点
classmap 的扫描逻辑依赖 PHP 的 token_get_all()，它读取的是源码字面量，所以以下情况全算“不一致”：
- 文件中类定义是
class usercontroller，但你期望用new UserController()——classmap登记的键就是"usercontroller" - 目录名用了大写
Src/，但composer.json写的是"src/"，Linux 下扫描不到任何文件，自然没映射 - 你用 IDE 自动重命名类，结果改了类名但没同步改文件名（比如类改成
CacheManager，文件还叫cacheManager.php），classmap仍按旧文件名扫描
修复 classmap 大小写问题的实操步骤
核心原则：让类名、文件名、映射键三者完全一致，且符合 PSR-4 约定（即使你只用 classmap）：
- 统一用大驼峰命名类和文件：
UserService.php→class UserService - 确保
composer.json的classmap数组指向的是**包含该类的完整路径**，且路径大小写与实际文件系统一致（"src/Service/UserService.php"✅，"src/service/userservice.php"❌） - 删掉
vendor/composer/autoload_classmap.php后再跑composer dump-autoload --optimize，避免旧缓存干扰 - 如果项目混用 PSR-4 和 classmap，注意
classmap优先级更高——哪怕 PSR-4 路径对了，只要classmap里有同名但大小写错的键，就会命中错误路径并报Cannot declare class
classmap 不是兜底方案，它是精确匹配。它不关心你写了什么命名空间，只认你文件里 class XXX 这行字面量。改完必须重扫，而且得扫对地方。
