ThinkPHP路由在Windows和Linux下因路径解析、Web服务器重写规则、缓存机制差异易出404等问题：Apache需启用.htaccess且AllowOverride为All，Nginx须配置try_files转发并禁用PATH_INFO；URL大小写敏感需设url_case_insensitive=true或统一小写命名；opcache与realpath_cache需临时关闭并清缓存；模板引用及文件名必须全小写。
ThinkPHP路由配置在Windows和Linux系统下表面看只是写法一致，实际运行时却常因路径解析、Web服务器重写规则、缓存机制三处底层差异导致404、路由不生效或反射失败——这些不是配置错，而是环境没对齐。
Web服务器重写规则必须按系统适配
Windows下Apache默认启用.htaccess，但Linux（尤其Nginx）需手动配置转发规则，否则请求根本进不了ThinkPHP路由层。
Apache用户：确认项目根目录存在.htaccess文件，且对应
Nginx用户：在server块内添加location / { try_files $uri $uri/ /index.php?$query_string; }，【不能写成/index.php?s=$1，TP6+已弃用PATH_INFO模式】。
立即学习“PHP免费学习笔记（深入）”；
宝塔用户：选“ThinkPHP”伪静态模板后，必须打开生成的nginx.conf，确认规则已写入当前站点配置段，再执行nginx -t && systemctl reload nginx验证生效。
URL大小写敏感性要主动声明
Windows文件系统不区分大小写，Linux严格区分，而ThinkPHP默认按类名/路径字符串精确匹配，URL访问时大小写不一致就会触发404或模板不存在错误。
方法一：在config/app.php中设置'url_case_insensitive' => true，让框架自动忽略URL路径大小写差异。
方法二：禁用该选项，改为强制统一小写——所有控制器类名、模板文件名、路由定义中的模块名全部使用小写命名，例如IndexController → indexcontroller.php，view/index/index.html → view/index/index.html（保持全小写）。
【注意：开启url_case_insensitive后，URL生成函数U()仍按原始大小写输出，前端链接可能混用大小写，建议配合Nginx重定向规则统一转小写】
在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……
路径缓存与opcache必须清理或关闭
Windows下PHPStudy等集成环境默认启用opcache，且realpath_cache会固化错误路径大小写映射，导致spl_autoload找不到控制器类，报ReflectionException或class not found。
第一步：打开php.ini，将opcache.enable=1改为opcache.enable=0；
第二步：在php.ini末尾添加realpath_cache_size = 0；
第三步：重启Apache/Nginx服务；
第四步：清空runtime/cache/目录下所有文件；
第五步：确认能正常访问后，可将opcache.enable恢复为1，但保留realpath_cache_size = 4096（不可设为0长期运行）。
模板路径引用必须避免硬编码大小写
ThinkPHP模板引擎中{include file="Index/index"}这类写法，在Windows下能加载成功，Linux下直接报template not exists——因为file属性未做大小写归一化，而是拼接VIEW_PATH后调用file_exists()校验。
统一改用小写路径引用：{include file="index/index"}、{include file="admin/user_list"}；
控制器中调用View::fetch()时，参数也必须全小写：View::fetch('index/index')；
【关键前提：app/view/下的目录名和文件名本身必须是全小写，例如不能存在app/view/Index/Index.html】
