ThinkPHP 8 中模板路径不按驼峰转小写下划线时，需手动指定：用 $this->fetch('api/index') 或 view('admin_v2/dashboard') 绕过自动推导；跨模块或非标准路径须用绝对路径如 /common/header；{include} 起点为当前模板目录，统一加前置斜杠。
模板路径不按驼峰转小写下划线，怎么手动指定
ThinkPHP 8 默认把 UserController → user_controller → 再转成 user 目录名，但如果你的控制器类名是 APIController 或 AdminV2Controller，自动推导会失败，直接报 Template not found。这时候不能靠“改类名”，得在控制器里显式告诉框架模板在哪。
-
$this->fetch('api/index')：跳过自动推导，直接按字符串路径找app/view/api/index.html -
return view('admin_v2/dashboard', ['data' => $data])：用门面调用，同样绕过类名解析逻辑 - 若控制器继承自
think\Controller，还可重写getTemplatePath()方法，返回自定义路径前缀（如return './view/custom/';）
跨模块或非标准目录结构下 fetch() 怎么写才不崩
默认 $this->fetch('index') 是相对当前控制器所在模块的 view/ 子目录，但如果你的模板放在 app/view/common/ 或 app/view/shared/ 这类非模块平级路径下，必须用绝对路径写法。
- 写法一：
$this->fetch('/common/header')（开头带/表示从view/根开始） - 写法二：
$this->fetch('index@common/header')（@前是模块名，仅当common是合法模块时有效） - 写法三：用门面 + 绝对路径：
View::fetch('/shared/footer', ['copyright' => date('Y')]) - 注意：
$this->fetch('./footer')或$this->fetch('../common/header')全部无效 —— ThinkPHP 不解析.和..
为什么 {include} 里的路径和 fetch() 不统一
这是最容易混淆的点：$this->fetch() 的路径起点是 view/ 根目录，而 {include file="xxx"} 的起点是「当前模板所在目录」。比如你在 app/view/user/profile.html 里写 {include file="header"}，它会去找 app/view/user/header.html，不是 app/view/header.html。
- 统一做法：所有
{include}都加前置斜杠，如{include file="/common/header" /} - 传参时别写 PHP 数组：
{include file="/common/nav" menu_items="[{'name':'首页'}]"}会直接报错或静默忽略 - 正确传参：
{include file="/common/nav" menu_items=$menu_list}，且确保$menu_list已在控制器中用assign()或fetch()第二个参数传入 - 嵌套包含时，子模板里再用
{include}，路径依然以它自己所在目录为起点，不是父模板的目录
模板后缀、大小写、路径分隔符这些细节为什么总出问题
Linux 服务器上一个字母大小写不对、多一个斜杠、后缀写成 .htm 而不是 .html，都会导致 404。TP8 对路径极其敏感，且不报明确错误，只显示空白或 Template not found。
立即学习“PHP免费学习笔记（深入）”；
-
config/view.php中确认'view_suffix' => 'html'，且所有模板文件真实后缀必须一致 - 路径全部用小写：哪怕 Windows 开发时能跑通，上线到 Linux 就挂，
User/Index.html≠user/index.html -
'view_path' => './view'末尾不能有斜杠，写成'./view/'在部分系统下拼接路径时会多出双斜杠，导致匹配失败 - 检查实际文件路径是否和配置完全一致：用
realpath(app_path() . 'view/user/index.html')打印出来看是否存在
{include} 和 fetch() 混用时搞错了起点。建议第一次调试时，直接打印出 TP8 最终拼出来的完整模板路径，比猜快得多。 
