classmap不是写完配置就自动生效的机制，必须手动运行composer dump-autoload才能加载新类；它不解析命名空间、不猜测路径，仅通过静态扫描生成硬编码映射表，且路径配置错误会静默失败。
classmap 不是写完配置就自动生效的机制，必须手动运行 composer dump-autoload 才能加载新类；它不看命名空间、不猜路径，只靠静态扫描生成硬编码映射表。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
classmap 配置写错路径会静默失败
Composer 只扫描 composer.json 中 "autoload": {"classmap": [...]} 明确列出的路径，且路径必须满足：
- 以项目根目录为基准，写相对路径（如 "lib/"，不是 "./lib/" 或 /var/www/lib）
- 目录路径末尾必须带 /（写成 "lib" 会被当作文本文件读取，报 Could not scan for classes）
- 不支持 ** 或通配符（"src/**/*.php" 无效），但支持单文件（"src/Utils.php"）和 glob（"legacy/DB_*.php"）
- Windows 下也统一用 / 分隔（"lib/utils.php"，别写 "lib\utils.php"）
- 若路径不存在或为空目录，Composer 默认跳过，不报错也不提示
新增类后 Class not found？大概率没重跑 dump-autoload
classmap 是纯静态映射，不会监听文件变化。常见现象：
- 新增 lib/Cache.php 并在 composer.json 中加了 "lib/"，但 new Cache() 仍报错
- 检查 vendor/composer/autoload_classmap.php 是否包含 'Cache' => $abs_path —— 如果没有，说明扫描没触发
- 必须执行：composer dump-autoload（开发时）或 composer install --optimize-autoloader --classmap-authoritative --no-dev（生产部署）
- 注意：composer update 或 install 默认不重建 classmap，除非加 --optimize-autoloader
--classmap-authoritative 不是加速银弹，用错直接炸锅
这个参数让 autoloader 完全信任 autoload_classmap.php，跳过所有 PSR-4 fallback 查找，但代价明显：
- 必须搭配 --optimize-autoloader（即 -o），否则映射表为空，所有类都找不到
- 任何未登记的类（包括运行时生成的 Proxy 类、缓存 warmup 生成的类、甚至 autoload.files 里 require 的文件）都会直接抛 Class not found
- autoload-dev 下的路径如果也被扫进主映射（比如误把 tests/ 加进 autoload.classmap），上线后可能意外加载测试逻辑
- Docker 构建中写 RUN composer install --classmap-authoritative 是错的，必须显式加 --optimize-autoloader
真正容易被忽略的是：classmap 的“一次性快照”属性——它不校验类是否存在、不关心命名空间、也不管你有没有 use 或 new，只认扫描那一刻的文件内容和路径。改一个类名、挪一个文件、删一个旧类，都得重跑命令，否则 autoload 就是过期状态。
