classmap 是 legacy 项目自动加载的首选方案，适用于无命名空间、类名含下划线、文件分散的旧代码；需确保路径真实存在且不以斜杠结尾，新增文件后必须执行 composer dump-autoload。
classmap 是 Legacy 项目自动加载的第一块垫脚石
旧项目没命名空间、类名带下划线（User_model）、文件散落在 models/ libraries/ includes/ 里——这时候别碰 psr-4，它会直接报错或静默失效。直接上 classmap 最稳。
常见错误现象：Class User_model not found，但文件明明存在；或者执行 composer dump-autoload -o 后仍加载失败。
-
classmap路径必须真实存在，结尾不能带斜杠（"models/"❌，"models"✅） - 路径是相对于
composer.json所在位置的，不是vendor/autoload.php - 新增类文件后，必须重新运行
composer dump-autoload，否则不会被扫描到 - 如果某个目录下混有非 PHP 文件（如 .gitignore、README.md），Composer 会跳过它们，不影响映射生成
files 加载纯函数文件时的顺序与副作用
像 helpers/common_helper.php 这种只定义函数、不声明类的文件，必须用 files 字段，而不是塞进 classmap——后者会尝试解析类名，遇到 function foo() {} 就报 Parse Error。
容易踩的坑在于：多个 files 条目之间没有加载顺序保证，且所有 files 都会在每次请求时无条件 require_once。
-
files里的路径也必须相对composer.json，比如"helpers/common_helper.php" - 不要把含
class声明的文件放进files，否则和classmap或psr-4冲突，触发Cannot declare class - 若 helper 之间有依赖（如
string_helper.php依赖array_helper.php），应合并为一个文件，或改用封装成类 +classmap
psr-4 和 classmap 共存时的优先级陷阱
当你开始给部分模块加命名空间（比如 RedeStore），同时老代码还靠 classmap 加载，就得注意加载顺序——不是配置先后，而是 Composer 内部注册顺序。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实际行为是：psr-4 映射先注册，classmap 后注册；但一旦某个类名被 psr-4 规则匹配到路径，就不再往下查 classmap。所以冲突往往发生在“同名但不同路径”的类上。
- 例如
RedeStore在psr-4下指向app/model_common/Rede/Store.php，而classmap也扫到了legacy/RedeStore.php——PHP 只认第一个加载的 - 解决办法：确保新命名空间类不和旧全局类重名；或用
classmap显式排除旧文件（删掉或移出扫描目录） -
psr-4命名空间前缀末尾必须带反斜杠（"Rede\"），写成"Rede"会被当作 PSR-0 兼容模式处理，在 Composer 2.x+ 中可能完全失效
vendor/autoload.php 必须放在入口文件最顶部
这是整个迁移成败的关键动作，不是建议，是硬性要求。旧项目常见的启动流程是先 require 'config.php' 再 require 'database.php'，最后才 require 'user_model.php'——这种顺序会让自动加载器彻底失效。
原因很简单：PHP 不允许重复 class 声明。一旦 User_model 被手动 require 过，Composer 的 classmap 就再也加载不了同名类。
- 入口文件（如
index.php）第一行必须是require __DIR__.'/vendor/autoload.php'; - 所有旧的
require或include都得删掉或注释掉，交给 Composer 统一加载 - 如果某些文件依赖 config 或 db 初始化才能加载（比如数据库模型需先连 DB），那说明这些文件本身不该是类，而是初始化逻辑——应拆出来单独调用，而非塞进 autoload
真正难的不是写对 composer.json，而是说服团队接受“删掉所有手动 require”这件事。路径、命名、顺序，每一步都卡在旧习惯上。
