autoload_classmap.php 未包含类是因为 classmap 仅扫描 composer.json 中明确声明的路径，不自动发现新类；路径须相对且无尾斜杠，文件需预先存在、大小写严格匹配。
classmap 生成后为什么 autoload_classmap.php 里没你的类？
因为 classmap 只扫描 "autoload": {"classmap": [...]} 里明确列出的目录或文件，不会自动发现新类——哪怕它们在 src/ 下且命名规范。Composer 不做“猜测式扫描”。
- 确保路径是相对于
composer.json所在目录的，比如写"src"而不是"./src"或绝对路径 - 路径末尾不加斜杠（
"src/"是错的，会静默忽略） - 如果类文件是动态生成的（如 stubs 或构建产出），必须在运行
composer dump-autoload前已存在 - 注意大小写：Windows 上可能“不敏感”，但生产环境（Linux）严格区分，
MyClass.php和myclass.php只有一个会被收录
什么时候该用 composer dump-autoload --classmap-authoritative？
这个开关会让 Composer 完全跳过 PSR-4/PSR-0 的文件系统查找，只查 autoload_classmap.php —— 适合部署后代码不再增删的场景，能提升 10%~30% 的类加载速度。
- 仅在确认所有类都已被 classmap 覆盖时启用，否则会报
Class not found - CI/CD 打包阶段建议加上，配合
--no-dev和--optimize-autoloader - 开发中禁用：改一个类就得重跑 dump，否则新类永远加载不到
- 它和
--classmap-authoritative不兼容"autoload-dev"的 classmap，dev 类不会进主 classmap
composer dump-autoload -o 和 -a 的区别到底在哪？
-o（--optimize）是默认行为的增强：它把 PSR-4 映射也预生成进 autoload_classmap.php，但依然保留 fallback 查找逻辑；-a（--classmap-authoritative）则是彻底关闭 fallback。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer dump-autoload -o：安全提速，推荐日常使用；autoload_classmap.php变大，但类加载更稳 -
composer dump-autoload -o -a：激进提速，要求 100% 覆盖，漏一个就崩 - 两者都会重新生成
autoload_psr4.php等辅助文件，但只有-a会让 Autoloader 强制忽略它们 - PHP 7.4+ 下
-o还会合并重复的命名空间映射，减少数组 size
为什么线上跑了 dump-autoload -o -a 还是慢？
classmap 缓存本身很快，但瓶颈常在别处：比如你用了大量 class_exists('Foo', false)，而 false 参数会绕过 autoloader，导致 classmap 白建了；或者框架在启动时反复 require 同一文件。
- 检查是否真在用 classmap 加载：在类加载器里打日志，看走的是
findFileWithExtension还是findFile - 避免在循环里调
class_exists或interface_exists，尤其带false参数时 - 确认 opcache 已启用且
opcache.enable_cli=1（CLI 环境下也生效） - classmap 文件体积过大（>2MB）时，PHP 反序列化开销明显，这时该拆分 autoload 配置，按模块分组
classmap 不是银弹，它解决的是“定位类文件”的开销，而不是“加载并解析 PHP 文件”的开销。后者得靠 opcache 和代码结构优化。
