classmap需手动执行composer dump-autoload生效，路径须为相对路径、目录加斜杠、注意加载优先级及大小写敏感，启用--classmap-authoritative前须确保100%类被扫描到。
classmap 不会自动扫描新增文件，必须手动运行 composer dump-autoload 才能生效；它只认你写进 composer.json 的路径，且不解析命名空间、不执行代码、不监听文件变化。
classmap 怎么配路径才不报错
路径必须是相对于 composer.json 所在目录的相对路径，不能用绝对路径（如 /var/www/project/lib），否则换环境就失效。目录末尾加不加 / 都行，但写成 "lib"（无斜杠无扩展名）会被当作文本文件尝试读取，触发 Could not scan for classes 错误。
-
"lib/"和"lib"效果不同：前者是目录，后者是文件名，务必加斜杠表示递归扫描 - 支持通配符（如
"legacy/DB_*.php"），但仅 Composer ≥ 2.2 支持；旧版本只接受目录或完整文件路径 - 路径不存在时，
composer dump-autoload默认静默跳过，不会报错——容易误以为配置成功，建议 dump 后立刻检查vendor/composer/autoload_classmap.php是否有目标类 - Windows 下统一用
/分隔路径，Composer 内部会自动适配
为什么 new 类时还是 Class not found
最常见原因是：类文件被 PSR-4 规则提前匹配了，导致 classmap 根本没机会查。Composer 加载顺序固定为 psr-4 → psr-0 → classmap → files，一旦前面命中就终止查找。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查该类是否落在某个 PSR-4 映射路径下（比如
"App\" → "src/"），如果src/legacy/User.php里定义了class User，它就会被 PSR-4 先加载，classmap 里的同名类无效 - 类名大小写必须完全一致：Linux 下
class stringhelper和new StringHelper()匹配失败，classmap 条目是小写的，而调用是大写的 - 文件里有语法错误（哪怕只是多一个
?），classmap 扫描会跳过该文件且不报错 - 类定义在条件块中（如
if (false) { class A {} }）不影响扫描——classmap 只做词法分析，但eval("class A {}")或class_alias()完全无法识别
什么时候该加 --classmap-authoritative
这个参数会让 Composer 认为“所有类都必须在 classmap 里”，跳过后续所有 PSR-4/PSR-0 查找逻辑，从而减少多次 file_exists() 系统调用，提升性能。但它极度脆弱，启用前必须确保：
- 项目中所有可能被
new或class_exists()触发的类，100% 被 classmap 扫到（包括测试类、命令类、事件类等） - 没有遗漏任何路径，尤其是
autoload-dev里配的 classmap 路径也要一并 dump 进去 - CI/CD 构建流程中明确加上
--optimize-autoloader --classmap-authoritative，否则本地跑通线上仍可能报错 - 一旦启用却漏扫一个类，错误信息就是直白的
Class XXX not found，没有任何 fallback 提示
classmap 最容易被忽略的点是：它不解决“类定义在哪”的问题，只解决“类名→文件路径”的映射问题；如果你的类本身写在 .inc 或 .hh 文件里，或者压根没用 class 关键字声明，那再怎么配路径也扫不到。
