PSR-4映射不生效需检查四点：autoload位置（生产类须在autoload非autoload-dev）、dump-autoload是否执行、-o与-a参数误用、命名空间末尾双反斜杠\缺失；多映射时顺序决定优先级，具体前缀应置前。
PSR-4映射不生效？先检查autoload和autoload-dev位置
Composer只读取composer.json根级的autoload字段，autoload-dev仅在composer install --dev或composer dump-autoload时参与生成，但运行时不会自动加载其中的命名空间。常见错误是把测试工具类（如Tests\）配在autoload-dev里，却在生产环境代码中直接new TestsFooTest()——这会抛出Class not found。
实操建议：
- 生产用类必须进
autoload.psr-4，哪怕只是临时调试用的工具类 -
autoload-dev.psr-4只放真正仅用于开发流程的类（例如PHPUnit扩展、自定义命令行工具），且确保调用方也在autoload-dev范围内或明确require - 修改后务必执行
composer dump-autoload，而非仅composer install
composer dump-autoload -o和-a的区别直接影响类发现速度
加-o（optimize）会生成vendor/composer/autoload_classmap.php，把所有类路径预编译成数组，跳过文件系统扫描；加-a（classmap-authoritative）则强制只走这个数组，完全忽略PSR-4目录遍历。两者叠加能显著提速，但代价是：新增类文件后，不重新dump-autoload就找不到。
实操建议：
- 线上环境应使用
composer dump-autoload -o -a，但CI/CD流程中必须确保每次部署都触发该命令 - 本地开发禁用
-a，否则改完一个.php文件还得手动重刷autoload - 若项目含大量动态生成类（如模板编译器产出），
-a会导致类丢失，此时只能用-o保底
嵌套命名空间映射时，尾部反斜杠\不能省略
PSR-4规范要求映射值末尾必须有，否则Composer会把命名空间前缀当成“精确匹配”，导致子命名空间失效。例如"App": "src/"合法，而"App": "src/"会让AppServicesFoo被解析为srcServicesFoo.php（错误路径），而非预期的src/Services/Foo.php。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 所有
psr-4键值对的key末尾必须带双反斜杠\，这是硬性语法要求 - value路径末尾不加
/更安全（Composer内部会自动补），避免"src//"这类冗余写法 - 用
composer validate可捕获缺失\的配置错误，提示类似Invalid PSR-4 mapping: App -> src/
多个PSR-4映射冲突时，顺序决定优先级
Composer按composer.json中psr-4对象的书写顺序匹配命名空间，遇到第一个匹配项即停止。比如同时配置了"App\": "src/"和"App\Models\": "legacy/models/"，那么AppModelsUser永远走src/Models/User.php，后一条映射形同虚设。
实操建议：
- 更具体的命名空间要写在前面，例如
"App\Models\"、"App\Controllers\"放在"App\"之前 - 避免用同一前缀做多级映射（如
"App\"和"App\Utils\"），极易引发维护困惑 - 用
composer show -p可查看当前生效的完整类映射表，验证是否符合预期
最易被忽略的是：当项目引入第三方包并修改其autoload配置时，Composer会合并所有psr-4规则，而你的根composer.json顺序只影响自身条目——第三方包的映射插入位置不可控，必要时得靠classmap兜底。
