classmap是遗留代码唯一能走通的自动加载路径，它不验证命名空间、不比对文件名、支持.inc等扩展名，仅需在composer.json中正确配置相对路径并执行composer dump-autoload或composer install --no-dev --optimize-autoloader生成映射表。
classmap 是遗留代码唯一能走通的自动加载路径
PSR-4 不认无命名空间的 User 类，PSR-0 在 Composer 2.x 中已被完全移除，files 只能加载函数/常量——真正能覆盖老项目里 user.class.php、DBHelper.inc、Config.php 这类文件的，只有 classmap。它不验命名空间、不比对文件名、不跳过 .inc，只要文件里有 class X、interface Y 或 trait Z，就能扫进去。
配置 classmap 时路径写错就等于没配
路径必须是相对于 composer.json 所在目录的字符串，且末尾斜杠可选但建议加上，避免误判为文件名：
-
"classmap": ["lib/", "includes/", "legacy/"]—— 正确，递归扫描 -
"classmap": ["./lib/"]—— 错误，./前缀被忽略，实际不扫描 -
"classmap": ["lib"]—— 错误，Composer 会当作文本内容读取，静默跳过 -
"classmap": ["/var/www/project/lib/"]—— 错误，绝对路径不支持
Linux 部署时大小写必须完全一致：LegacyDB 类对应的是 legacy/Db.php 还是 legacy/DB.php？错了就进不了映射表。
新增类后不执行 dump-autoload = 白忙一场
classmap 不是运行时扫描机制，它依赖静态生成的映射表 vendor/composer/autoload_classmap.php。常见错误现象：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 加了
src/Utils/Helper.php，但new Helper报Class not found - 改了类名，旧类还能 new 出来，新类死活加载不到
- 本地 OK，上线报错——CI/CD 脚本漏掉了
composer dump-autoload
实操建议：
- 每次增删类文件后，立刻运行
composer dump-autoload - 生产部署务必用
composer install --no-dev --optimize-autoloader，否则autoload_classmap.php里全是未优化的冗余路径 - 怀疑没生效？直接打开
vendor/composer/autoload_classmap.php，搜索类名看是否存在对应键值
classmap-authoritative 模式上线前必须验证全覆盖
启用 --classmap-authoritative 后，Composer 彻底关闭 PSR-4 fallback，任何未出现在 autoload_classmap.php 中的类都会直接报错——哪怕文件真实存在、路径也对。这模式不是为了“提速”，而是为了“堵漏”。
上线前必须确认：
- 所有要使用的类（包括第三方 SDK、
.inc文件里的类、单文件多类）都已被classmap扫到 - 命令中同时带上
--optimize-autoloader和--classmap-authoritative，缺一不可 - Docker 构建或 CI 流程中，
dump-autoload必须在install之后、打包之前执行
最容易被忽略的一点：老项目常有 require_once 'xxx.php' 的手动加载逻辑，这些必须全部删掉，否则和 classmap 加载冲突，触发 Cannot redeclare class。
