命名空间加载失败主因是composer配置与路径不匹配，需用composer dump-autoload -v排查psr-4映射、json格式、目录大小写及autoload.php引入问题。
命名空间加载失败，90% 不是代码写错，而是 Composer 没把你的路径和命名空间对上 —— 直接看 composer dump-autoload -v 输出，比猜快十倍。
为什么 Class 'AppHttpControllersHomeController' 找不到，但文件明明在 src/Http/Controllers/HomeController.php？
这是最典型的 PSR-4 路径推导断裂。Composer 不是“看到 src/ 就扫里面所有 PHP 文件”，而是按配置的前缀截掉命名空间再拼路径。
- 若
composer.json里写的是"App\": "src/"，那AppHttpControllersHomeController必须落在src/Http/Controllers/HomeController.php—— 注意不是src/App/Http/...，App这个前缀被完全截掉了 - 如果类文件实际在
app/Http/Controllers/，但配置写成"App\": "src/"，dump-autoload -v 的输出里根本不会出现app/这个扫描路径，更不会映射任何类 - 命名空间声明少一个反斜杠（比如写成
namespace AppHttpControllers;✅ 正确，但误写为namespace AppHttpControllers❌ 缺末尾分号？不，是缺反斜杠——PHP 允许，但 Composer PSR-4 匹配时会按完整命名空间字符串比对，导致不命中）
composer dump-autoload -v 输出里压根没扫你的目录？先查这三处
加 -v 是关键，它会逐行打印：扫描了哪些路径、跳过了哪些文件、是否识别到你的 PSR-4 条目、有没有报 JSON 解析警告。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查
composer.json中autoload段缩进是否合法（JSON 不允许 tab、尾逗号不能多）、字段名是不是拼错成autoloader或auto_load - 确认你改的是项目根目录下的
composer.json，而不是某个子包里的；CI 环境下容易拉错工作目录 - 运行
composer show -s，看输出里autoload配置是否已生效 —— 如果这里都为空，说明配置根本没被读取，dump-autoload再跑十遍也没用
PSR-4 和 classmap 混用时，为什么新类走了 classmap 却不走 PSR-4？
classmap 查表是自动加载的第一步，PSR-4 是 fallback。一旦 classmap 映射表里有某类，就不会再走 PSR-4 推导。
- 如果你在
autoload.classmap里加了"src/Helper.php"，又在src/Helper.php里定义了class Helper，那new Helper()就永远走 classmap，哪怕你同时配了"App\": "src/" - classmap 路径必须写相对路径，如
"lib/"，不能写"./lib/"或绝对路径；且新增文件后必须重跑composer dump-autoload（classmap 不自动发现） - 执行
composer dump-autoload -o后，vendor/composer/autoload_classmap.php会生成全量列表；但若你只想让个别工具类走 classmap，主业务仍走 PSR-4，就别加-o，否则 IDE 跳转和静态分析可能失效
Linux 下报错但 Windows 能跑？大概率是大小写没对齐
PHP 类名解析严格区分大小写，而 Windows 文件系统默认不区分。部署到 Linux 就崩。
-
namespace AppHttpControllers;+class HomeController→ 文件名必须是HomeController.php，不能是homecontroller.php或HomeController.PHP - 目录名也一样：
src/Http/Controllers/不能写成src/http/controllers/，即使命名空间里是小写，PSR-4 推导时仍按目录实际大小写匹配 - 用
ls -l src/Http/Controllers/看真实文件名，别信 IDE 左侧文件树的显示（有些编辑器会自动首字母大写渲染）
最常被忽略的一点：vendor/autoload.php 是否真被引入？CLI 脚本里漏掉 require __DIR__ . '/vendor/autoload.php';，或 Web 入口用了错误相对路径（比如从子目录访问却写 ../vendor/autoload.php），都会让整个 autoload 失效 —— 此时 dump-autoload 再精准也没用。
