classmap条目未生效需先检查autoload_classmap.php是否含目标类名；常见原因有classmap路径非相对路径、存在语法错误PHP文件、混入非.php文件、工作目录非项目根、配置拼写错误；应删旧autoload文件后加-v重生成，并注意classmap优先级高于psr-4。

classmap 条目没生效，先看 autoload_classmap.php 里有没有

Composer 最终靠 vendor/composer/autoload_classmap.php 文件做类名到路径的硬映射。如果类找不到，但你确认文件存在、路径也对，第一件事就是打开这个文件，搜索你的类名（比如 UserRepository）——没出现就说明根本没被扫进去。

常见原因包括：

• composer.json 中 classmap 配置写的是绝对路径或带 ./ 前缀（必须是相对路径，如 "lib/"）
• 目标目录下有语法错误的 PHP 文件（composer dump-autoload 会静默跳过，不报错）
• 目录里混入了非 .php 文件（如 .php5、.inc），默认不扫描
• 执行 dump-autoload 时当前工作目录不是项目根目录，导致路径解析错位

加 -v 参数才能看到 classmap 扫描过程

不加 -v，composer dump-autoload 就像黑盒：成功了也不告诉你扫了哪些目录、跳过了什么文件、为什么某条 classmap 没进表。加了 -v 后，输出会逐行列出：

• 正在扫描的每个 classmap 路径
• 该路径下找到的所有 .php 文件
• 哪些文件因语法错误/空文件/无类声明被跳过
• 最终生成了多少个类映射条目

如果你的 lib/Helpers/ 没出现在 -v 输出里，说明配置压根没读到——回头检查 composer.json 缩进、逗号、字段名是不是拼成了 class_map 或 autoload-classmap。

删掉旧 autoload_*.php 再 dump，否则可能读缓存

composer dump-autoload 默认不会覆盖已存在的 autoload_classmap.php，而是直接写入；但如果 OPcache 或 APCu 缓存了它的字节码，你改了配置再 dump，PHP 还在跑旧映射。最稳妥的做法是手动清理：

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

• 删掉 vendor/composer/autoload_classmap.php
• 删掉 vendor/composer/autoload_static.php（优化模式生成）
• 再运行 composer dump-autoload -v

注意：别只删 autoload_classmap.php 却留着 autoload_static.php，后者优先级更高，会绕过你刚生成的新 classmap。

classmap 和 psr-4 冲突时，classmap 总是赢

一旦某个类名出现在 autoload_classmap.php 里，Composer 就不会再尝试用 PSR-4 规则推导路径。这意味着：

• 你删了 src/Helper.php，但 autoload_classmap.php 里还留着它，new Helper() 仍能跑（只是文件不存在，运行时报错）
• 你把类移到了 app/Services/ 并配了 PSR-4，但旧 classmap 条目还在，那它永远走老路径
• 想验证是否真走 classmap，可以临时注释掉 composer.json 里的 classmap 段，再 dump-autoload -v，看类名是否从输出中消失

classmap 不自动感知增删，它只认配置+扫描动作；所以每次删文件、改目录，都得重跑 dump-autoload，不能指望“它自己知道”。