根本原因是Linux文件系统严格区分大小写而Windows不区分，导致类名、文件名、路径大小写不一致时加载失败；需统一PascalCase命名、模板路径小写化、清理缓存、标准化上传文件名及语言包命名。
ThinkPHP项目在Windows开发环境能正常运行，但部署到Linux服务器后频繁报Class not found、template not exists等错误，根本原因是Windows文件系统不区分大小写，而Linux严格区分——类名、文件名、路径字符串只要有一个字母大小写不一致，加载立即失败。
统一控制器与模型文件命名规范
第一步：进入项目根目录，执行命令扫描所有小写结尾的PHP类文件：find . -path "./app/*" -name "*.php" | grep -E "(/[a-z]+\.php$|/[a-z][a-z0-9]*[A-Z][a-zA-Z0-9]*\.php$)"。该命令会揪出user.php、usermodel.php、userLogin.php等不合规命名。
第二步：将匹配到的文件逐个重命名为PascalCase格式。例如user.php → User.php，usermodel.php → UserModel.php，userLogin.php → UserLogin.php。注意不是简单首字母大写，而是类名必须与文件名完全一致（含大小写）。
第三步：打开对应PHP文件，检查class声明是否与新文件名严格对应。若文件已改名为UserLogin.php，但内部仍为class userlogin或class Userlogin，必须同步改为class UserLogin。ThinkPHP的PSR-4自动加载机制只认app\controller\UserLogin→app/controller/UserLogin.php这一种映射关系，其余全部失效。
立即学习“PHP免费学习笔记（深入）”；
修复模板路径大小写引用
方法一：全局搜索模板中所有{include file=、{extend file=、{import file=语句，将引号内路径全部转为小写+连字符格式。例如{include file="Public/Header"}→{include file="public/header"}，{extend file="Admin/layout"}→{extend file="admin/layout"}。
方法二：在config/template.php中强制统一模板路径解析行为，添加配置项：'view_path' => app()->getAppPath() . 'view' . DIRECTORY_SEPARATOR,，并确保view/目录下所有子目录名（如index、admin、public）均为全小写，且内部HTML文件名也全小写（index.html而非Index.html）。
【关键前提】Linux下view/admin/Layout.html与view/admin/layout.html是两个不同文件，模板引擎不做大小写归一化，直接拼接后调用file_exists()——错一个字母就跳过。
清理Composer自动加载缓存
进入项目根目录，依次执行以下命令：
composer dump-autoload -o→php think clear:route→php think clear:config→rm -rf runtime/cache/
这四步缺一不可。其中composer dump-autoload -o会强制重生成优化后的vendor/composer/autoload_classmap.php，覆盖Windows环境下可能残留的小写路径映射；后三步清除ThinkPHP自身缓存，避免旧路由规则和配置继续干扰。
上传文件名大小写保真处理
方法1：弃用$file->getClientOriginalName()，改用$file->hashName()保存物理文件。该方法返回纯哈希值（如5d8a9b2e3f7c1.jpg），彻底规避大小写问题。
方法2：若业务强依赖原始文件名（如财务凭证需保留invoice_20260601.pdf），则必须在$file->move()前立即提取并标准化：$originalName = $_FILES['file']['name']; $safeName = mb_strtolower($originalName);，将$safeName存入数据库，同时用$originalName作为实际保存的文件名。
注意：绝不能在move()之后再读取$_FILES，PHP上传临时文件销毁后，该数组中的name字段只是字符串副本，不再反映磁盘真实状态。
多语言包文件名与配置对齐
检查config/app.php中'default_lang'配置值，例如设为'zh-CN'，则必须确保app/lang/目录下存在且仅存在zh-CN.php文件。若实际只有zh-cn.php，Linux下将无法加载。
推荐统一采用小写+连字符格式：把所有语言包文件重命名为zh-cn.php、en-us.php、ja-jp.php，并在配置中同步改为'default_lang' => 'zh-cn'。避免混用zh_CN、ZH-CN等变体，这些在Windows下可能“碰巧”成功，但在Linux下必然失败。
