不能在同一个 autoload 块混用 psr-0 和 psr-4，Composer 会静默忽略 psr-0、仅生效 psr-4 并报弃用警告；必须分层设计，用 classmap、psr-4、files 各司其职，且避免路径重叠。
不能在同一个 autoload 块里混用 psr-0 和 psr-4 —— Composer 会静默忽略 psr-0，只生效 psr-4，并报弃用警告。混合加载不是“怎么配”的问题，而是必须分层设计：用不同策略各司其职。
为什么 psr-0 + psr-4 配置不生效
Composer 的自动加载器是单通道优先级覆盖机制：psr-4 映射注册时会接管所有匹配的命名空间前缀；哪怕 psr-0 指向完全不同的目录，只要命名空间前缀重叠（比如都声明了 "App\": "src/"），psr-0 就会被跳过。
- 运行
composer dump-autoload -v会看到明确提示：Warning: The PSR-0 autoloading specification is deprecated - 即使
psr-0目录下有App_Foo.php，只要类名是AppFoo，就会走psr-4查找逻辑（即严格按目录结构匹配） -
psr-0已被 PHP-FIG 在 2014 年正式弃用，新项目不应再引入
如何安全组合 classmap、psr-4 和 files
这三者可以共存，且有明确优先级：classmap > psr-4 > files（仅用于函数/常量文件）。关键是路径不重叠、职责清晰。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
classmap：适合无命名空间的老类（如class User {}放在models/User.php），执行composer dump-autoload --classmap-authoritative后生成完整映射表 -
psr-4：只用于现代命名空间类，目录结构必须与命名空间一致（如AppControllersUserController→src/Controllers/UserController.php） -
files：仅加载含全局函数或define()的文件（如"src/helpers.php"），它们会在 autoload 初始化时require_once，不参与类查找 - 避免
classmap和psr-4指向同一目录，否则可能因扫描顺序导致部分类未被收录
遗留项目中让老代码和新命名空间共存
不改类名、不重构目录也能跑通，关键在于选对加载策略，而不是强行统一标准。
- 老代码没命名空间？用
"classmap": ["models/", "lib/"]，Composer 扫描后生成静态映射，new User()照常工作 - 老代码有命名空间但不规范（如
namespace appmodel;）？加一条轻量psr-4映射："appmodel": "models/"，比全切到 classmap 更精准 - 只有几个全局函数文件（如
functions.php）？放进"files"数组，别试图给它们套命名空间 - 入口文件（
index.php、cli.php）顶部加require_once __DIR__ . '/vendor/autoload.php'，并确保卸载旧__autoload()或spl_autoload_register()
动态注册 PSR-4 是唯一绕过 composer.json 静态限制的方式
当模块路径或命名空间需运行时决定（如多租户 SaaS 中按租户加载不同模块），composer.json 无法满足——它只在 install/update 阶段解析。
- 用
$loader->addPsr4('AppTenantModulesA', base_path('modules/tenant-a/src/'))动态注册 - 必须检查是否已存在该前缀：
in_array('AppTenantModulesA\', array_keys($loader->getPrefixesPsr4()))，防止重复注册污染加载器 -
composer dump-autoload对动态路径完全无感知，新模块加入后需重启 PHP-FPM 或容器才能生效 - 不要在
autoload.php里手动调用spl_autoload_register()，这会破坏 Composer 内部 loader 的执行顺序
真正容易被忽略的是 classmap 和动态注册的生命周期问题：前者依赖你主动重跑 dump-autoload，后者依赖进程重启。两者都不受 composer.json 变更的自动触发，得靠部署脚本或运维流程兜底。
