classmap 和 PSR-4 同时配置时类找不到的根本原因是 Composer 优先使用 PSR-4 规则，而 classmap 因路径错误、未重生成或文件无命名空间等未兜底生效；修改 classmap 后必须执行 composer dump-autoload 或 composer install --optimize-autoloader。
classmap 和 PSR-4 同时配置时类找不到
根本原因是 Composer 优先走 PSR-4 规则，但 classmap 又没兜底成功——比如你写了 "MyLib\": "lib/" 在 PSR-4 里，又在 classmap 里加了 "lib/Utils.php"，但 Utils.php 里没声明 namespace MyLib;，PSR-4 就直接跳过它，而 classmap 又因路径未被扫描或拼写错误没生效。
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 同一类名不能同时出现在 PSR-4 和 classmap 映射中，否则行为未定义，Composer 通常以 PSR-4 为准
- 确认
composer.json中"classmap"是顶层"autoload"字段下的数组，不是嵌套在"psr-4"里 - 检查
vendor/composer/autoload_classmap.php是否真包含你要的类名（如'Utils' => '/abs/path/lib/Utils.php'），没有就说明扫描失败 - 路径必须写成
"lib/"（末尾带斜杠），写成"lib"会被当作文本文件读取，静默跳过
新增类后仍报 Class not found
classmap 是静态快照，不会监听文件变化。你加了 lib/Cache.php 并更新了 composer.json 的 "classmap"，但没重跑命令，Composer 就完全不知道这个文件存在。
实操建议：
- 每次修改
"classmap"数组后，必须手动执行composer dump-autoload（开发）或composer install --optimize-autoloader（生产） - 用
-v参数看扫描过程：composer dump-autoload -v会打印“Scanninglib/for classes”，确认它真扫到了目录 - 如果目录下有语法错误、BOM 或短标签，扫描会在该文件中断，
-v输出会卡在那行，直接定位问题文件 - Windows 下路径统一用
/分隔，别写\，否则扫描失败且不报错
classmap 扫描路径写错却没提示
Composer 对 classmap 路径错误是静默容忍的：路径不存在、为空目录、甚至拼错成 "lbi/"，它都跳过，不报错也不警告。你看到 autoload 正常生成，但类就是加载不了。
实操建议：
- 路径必须是相对于
composer.json所在目录的**真实相对路径**，不能是./lib/或绝对路径 - 支持单文件（
"lib/Helper.php"）和 glob（"legacy/DB_*.php"），但不支持**通配符 - 删掉
vendor/composer/autoload_classmap.php再跑composer dump-autoload -o，比反复重试更可靠 - 用
ls -la确认路径真实存在，尤其注意大小写——Linux 下Lib/和lib/是两个目录
用了 --classmap-authoritative 却加载失败
这个参数让 autoloader 完全信任 autoload_classmap.php，跳过所有 fallback 查找。但一旦某个类没被扫进 classmap（比如动态生成的 Proxy 类、运行时拼接的类名、或 autoload.files 里 require 的文件），就会直接抛 Class not found。
实操建议：
- 仅在确定所有类都能被静态发现时启用
--classmap-authoritative，例如纯 PSR-4 + 明确 classmap 目录的项目 - 必须搭配
--optimize-autoloader（即-o），否则autoload_classmap.php为空，所有类都找不到 - Docker 构建中写
RUN composer install --classmap-authoritative是错的，漏了-o，必须写全--optimize-autoloader --classmap-authoritative - 上线前用
php -r "var_dump(class_exists('YourClass'));"快速验证关键类是否能被识别
use 或 new，它只认扫描那一刻的文件内容和路径——这既是它的确定性优势，也是出错时最难排查的盲区。 
