Linux下autoload失败90%因大小写不一致：命名空间、目录名、文件名三者必须逐字符大小写精准匹配，否则file_exists()返回false导致静默加载失败。
Linux下autoload失败，90%是大小写没对齐
类文件在Windows能加载、部署到Linux就报Class not found，基本可以断定是大小写问题。Composer的PSR-4加载器在Linux上用file_exists()做路径检查，而该函数区分大小写——src/Http/Controller/HomeController.php和src/http/controller/homecontroller.php是两个完全不同的路径。
常见踩坑点：
- IDE自动生成命名空间时把
namespace AppHttpControllers;写成namespace AppHttpcontrollers;（末级小写） - 目录名用了
models，但命名空间写的是AppModels，实际路径却是src/models/ - 类文件命名为
userservice.php，但类名是UserService，PSR-4要求首字母大写 - Git在Windows上提交了
Helper.php，但开发者重命名成helper.php后只改了文件名没改内容里的class Helper声明
验证命名空间、路径、文件名是否三者一致
别靠眼睛扫，用命令逐层确认：
1. 看命名空间声明是否带末尾反斜杠且大小写正确：head -n1 src/Services/UserService.php | grep 'namespace App\Services;'
2. 看文件系统里路径是否存在且大小写精准：ls -l src/Services/UserService.php（注意大小写全匹配）
3. 看autoload_psr4.php里映射是否指向正确基路径：php -r "var_dump(require 'vendor/composer/autoload_psr4.php');"，确认'App' => ['src/']这一项存在，且值是相对路径字符串，不是绝对路径
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
4. 最终验证是否真能加载：php -r "require 'vendor/autoload.php'; var_dump(class_exists('AppServicesUserService'));" → 返回bool(true)才算过
跨平台开发必须强制统一规范
Windows/macOS不区分大小写，会让错误“隐身”。上线前必须在Linux环境跑通，否则CI/CD一构建就崩。
建议动作：
- Git启用
core.ignorecase = false，避免文件名大小写变更被忽略 - CI流程中加一步：在Ubuntu runner上执行
composer dump-autoload && php -r "require 'vendor/autoload.php'; class_exists('AppServicesUserService') or die('autoload fail');" - 开发机也配个Docker容器（Alpine或Ubuntu镜像），日常改完类就进去跑一遍验证命令
- 用
composer validate检查composer.json语法，但它不校验大小写，所以只是第一道关
别指望Composer自动纠错，它只按字面量匹配
Composer不做任何大小写归一化、不尝试驼峰转小写、不 fallback 到近似路径。它拿到AppServicesUserService，就严格拼出$baseDir . '/src/' . 'Services/UserService.php'，然后调file_exists()——返回false就直接抛错，不打印警告，不记录日志，不提示你哪里错了。
最容易被忽略的点是：$baseDir的值来自vendor/composer/autoload_static.php里的硬编码路径，如果部署时把代码挪了位置（比如从/var/www/app移到/app），而composer.json里还写着"App\": "src/"，那拼出来的路径就是错的，连文件系统大小写都还没轮到检验。
