class_exists()返回false说明PSR-4映射未生效或命名空间与路径不匹配：必须确保"App\": "src/"中双反斜杠和路径结尾斜杠正确，且执行composer dump-autoload；文件名、目录名、namespace声明须大小写完全一致。

加了 PSR-4 映射但 class_exists() 返回 false？不是配置没生效，就是路径或命名空间对不上——Composer 不会猜你想要什么，它只按字面拼路径。

PSR-4 映射怎么写才不静默失效

最常踩的坑是双反斜杠和路径末尾斜杠写错，导致整个映射被忽略，且无任何报错提示。

• "App\": "src/" ✅ 正确：前缀以 \ 结尾，路径以 / 结尾（可选，但建议统一）
• "App": "src" ❌ 缺少反斜杠，PHP 字符串中 "App" 不等于 "App\"，前缀匹配失败
• "App\": "src/App/" ❌ 路径多了一层 App/，App\User 会被拼成 src/App/User.php，但实际文件在 src/User.php
• 路径必须相对于 composer.json 所在目录，不是当前工作目录、不是 vendor/、也不是 Web 根目录

新增类后为什么还是 Class not found

Composer 不监听文件系统变化，composer.json 改了、类文件也放好了，但不执行命令，autoload 文件就还是旧的。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 必须运行 composer dump-autoload（开发阶段够用）
• 若用了 -o 参数生成优化版，新增类后不会自动更新映射，调试时反而更难定位问题
• 验证是否生效：在代码里加 var_dump(class_exists('App\User'));，返回 true 才算成功
• 确认入口文件第一行已正确引入 require __DIR__ . '/vendor/autoload.php';，且没被其他 require 或 __autoload 干扰

子命名空间（如 App\Http\Controllers）怎么配

PSR-4 不支持单独为子级配一条规则，它靠“前缀 + 剩余命名空间段 = 目录层级”自动拼接路径。

• "App\": "src/" → App\Http\Controllers\Home 对应 src/Http/Controllers/Home.php
• 目录名必须与命名空间段完全一致：Http 不能写成 http 或 HTTP，Linux 部署直接报错
• 文件名必须与类名严格一致：Home.php 里只能有 class Home，不能是 class HomeController
• 多个前缀共存时，更具体的要写在前面，例如："App\Http\": "src/Http/" 必须在 "App\": "src/" 之前，否则宽泛规则先命中，子级映射永远不会触发

什么时候该换 classmap 或 files

PSR-4 不是万能的，强行套用只会让问题更隐蔽。

• 用 classmap：当类没命名空间、文件名不等于类名、或后缀是 .inc 时，比如 legacy/config.inc 里的 class DBConfig
• 用 files：只放纯函数、const、define()，路径写全，如 "src/helpers.php"（不是 "helpers.php"），且必须确保 vendor/autoload.php 已被引入
• 别把类定义塞进 files：后续 PSR-4 加载同名类会触发 Cannot redeclare class
• classmap 和 files 都需运行 composer dump-autoload，但 classmap 还得加 -o 才真正扫描生成映射

真正卡住人的往往不是语法，而是路径和命名空间之间那条看不见的映射线——它要求大小写、斜杠、反斜杠、目录层级全部严丝合缝。少一个 \，多一个 /，或者文件名差个大写，Class not found 就只甩给你一个空荡荡的错误，连哪一步错了都不会说。