Windows下ThinkPHP路由/模板路径大小写不敏感却报错，根本原因是Windows文件系统不区分大小写，但ThinkPHP加载机制依赖精确路径匹配，导致类或模板找不到；需确保文件名与类名严格一致、禁用opcache缓存路径、Linux部署前修复所有硬编码路径、模板引用统一小写、CI/CD中校验文件名大小写。
Windows下ThinkPHP路由/模板路径大小写不敏感却报错
这不是ThinkPHP的bug，是Windows文件系统默认不区分大小写，但ThinkPHP（尤其5.1+）在加载控制器、视图、配置文件时，会按类名或路径字符串做精确匹配，而底层自动注册的命名空间映射、模板解析逻辑依赖basename()和realpath()等函数——这些函数在Windows上返回的路径大小写可能和你写的类名不一致，导致class not found或template not exists。
常见现象：IndexController.php里定义了IndexController类，但URL访问/index/index报错；或者view/index/index.html存在，却提示找不到index/index模板。
- 检查你的控制器文件名是否全小写（如
indexcontroller.php），但类名首字母大写（IndexController）——Windows能读取文件，但spl_autoload根据类名找文件时，可能因大小写不一致失败 - 确保
app/controller/下的文件名与类名严格对应：类Admin\UserController→ 文件路径必须是app/controller/Admin/UserController.php（注意Admin和UserController首字母大写） - 关闭
opcache.file_cache_only（如果启用），它在Windows下缓存路径时可能固化错误大小写
Linux部署前必须修复的大小写硬编码路径
很多开发者在Windows开发时直接写死路径字符串，比如file_get_contents('./Config/database.php')或include 'common/function.php'，这类写法在Linux下因文件系统严格区分大小写立即失效。
ThinkPHP本身已用Loader::import()和think\facade\View::fetch()等封装路径解析，但业务代码里手写的require/include、file_exists()、scandir()调用极易踩坑。
立即学习“PHP免费学习笔记（深入）”；
- 所有手动路径拼接必须用
think\facade\App::getAppPath()或__DIR__代替相对路径，例如改include './config/db.php'为include App::getAppPath() . 'config' . DS . 'db.php' - 避免用
strtolower()或strtoupper()临时“修复”路径——这会让Linux下原本正确的路径反而错配 - 用
is_file()替代file_exists()判断文件，前者更严格，能提前暴露大小写问题
模板引擎中{include file="index/index"}大小写失效
ThinkPHP默认模板引擎对file属性不做大小写归一化，而是直接拼接VIEW_PATH后调用file_exists()。Windows下file_exists('index/index.html')可能命中INDEX/INDEX.HTML，但Linux下完全失败。
关键点在于：模板路径解析发生在think\template\driver\File::buildCache()阶段，它依赖think\facade\App::parseName()做标准化，但该函数默认不处理路径字符串里的大小写。
- 统一模板引用写法：全部使用小写路径 + 首字母大写控制器/方法名风格，如
{include file="public/header"}（对应view/public/header.html），且确保文件名确实是header.html而非Header.html - 禁用模板缓存调试期：
'tpl_cache' => false，避免旧缓存掩盖路径问题 - 检查
config/template.php中view_path是否含多余斜杠或大小写混用，如VIEW_PATH = APP_PATH . 'view' . DS比APP_PATH . 'View' . DS更安全
CI/CD流程中遗漏的大小写校验环节
Git默认在Windows上不追踪文件名大小写变更（git config core.ignorecase true），导致User.php重命名为user.php后，Linux构建机拉取的仍是旧文件名，运行时报Class 'user' not found。
这不是ThinkPHP的问题，但直接影响上线稳定性。
- 在Linux构建机上执行
git config core.ignorecase false，并运行git status确认文件名变更被识别 - CI脚本中加入校验步骤：
find ./app/controller -name "*.php" | grep "[A-Z]"，强制控制器文件名首字母大写 - 用
composer dump-autoload -o生成优化后的类映射，它会在生成时校验路径真实性，比运行时报错更早暴露问题
最麻烦的不是改代码，是团队协作中有人在Windows上改了文件名但没推Git，或者IDE自作主张重命名却不更新引用——这种问题往往要到线上才爆发，且日志里只显示“找不到类”，不会告诉你其实是usercontroller.php和UserController不匹配。
