classmap优化需正确配置composer.json的autoload.classmap路径、执行composer dump-autoload -o -a，且必须验证autoload_classmap.php中类名与路径存在；否则易漏类、空文件或上线崩溃。
classmap 优化不是加个 -o 就完事——它必须配合显式配置、正确路径和权威模式，否则生成的 autoload_classmap.php 很可能为空、漏类或根本没生效。
composer.json 里 classmap 配置写在哪、怎么填才被扫描
必须放在 autoload 或 autoload-dev 下的 classmap 数组里，值是字符串路径列表。常见错误是写错格式或路径不存在：
- 路径末尾带
/（如"src/"）表示递归扫描目录；不带（如"lib/Utils.php"）表示单个文件 - 错写成
"src"（无斜杠）会被当作文本读取，触发Could not scan for classes报错 - 支持 glob（如
"legacy/DB_*.php"），但不支持**或*单独用（"legacy/*.php"有效，"legacy/*"无效） - 路径必须真实存在，否则
dump-autoload只 warning 不中断，但对应类不会进映射表 - Windows 下统一用
/分隔符，Composer 内部自动适配
composer dump-autoload -o 为什么没生成 classmap 文件
因为 -o 本身不“生成” classmap，它只把已配置的 autoload 规则（包括 PSR-4 路径）转成扁平数组——前提是项目里有可扫描的类文件，且你已经声明了 classmap 或 PSR-4 映射：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 没在
composer.json中定义autoload.classmap或autoload.psr-4，-o就没东西可优化 - 只改了类文件但没重跑命令：新增类、删文件、改类名后，
autoload_classmap.php不会自动更新 -
composer install -o和composer dump-autoload -o效果不同：install -o会重建整个 autoload 结构，而dump-autoload -o只刷新已有规则，对空配置无效 - 误信
composer optimize-autoloader是合法命令——它根本不存在，属于拼写错误
如何真正触发完整 classmap 扫描并启用权威加载
最小可靠动作是运行 composer dump-autoload -a --classmap-authoritative --optimize-autoloader，三个参数缺一不可：
-
-a（--classmap-authoritative）强制跳过所有 fallback 查找，未登记类直接报Class not found -
--optimize-autoloader（或-o）让 Composer 把所有已知类路径写进autoload_classmap.php -
-a参数必须搭配--optimize-autoloader才生效，单独用无效 - 生成后务必检查
vendor/composer/autoload_classmap.php是否非空，并搜索你关心的类名确认路径是否正确 - 生产环境部署时，一定要加
--no-dev，否则autoload-dev下的测试类也会混入主 classmap，上线后可能因路径缺失立刻崩溃
classmap-authoritative 开启后哪些地方容易崩
它会让自动加载器彻底放弃文件系统查找，所以任何“未被扫描到”的类都会直接失败，且错误提示和开发时不一致：
- IDE 断点、热重载、运行时
require的类（比如插件机制动态加载）全部失效 - 漏配路径（如
tests/、app/Exceptions/、resources/lang/下的类）会导致上线后报错，但本地开发却正常 - 如果用了
files加载全局函数（如"app/Helpers/functions.php"），这些文件不会进 classmap，开了权威模式后它们仍能加载——但若误以为“所有 autoload 都走 classmap”，就会困惑为何某些函数可用而类不可用 - APCu 缓存的是 autoloader 实例，不是 classmap 数组本身；若
apc.shm_size太小（如32M），5000+ 类的映射表可能被逐出，反而增加 cache miss
真正起效的 classmap 不是靠猜参数，而是靠验证生成结果：打开 vendor/composer/autoload_classmap.php，搜你刚加的类名，看路径对不对、文件存不存在。漏扫比慢更危险——它不报错，只静默跳过。
