ThinkPHP5视图渲染是服务端PHP行为，fetch()返回HTML字符串需return交还框架，display()直接输出但绕过中间件；模板路径、后缀、变量赋值、编码、缓存等配置错误会导致空白或异常。
ThinkPHP5 视图模板渲染不依赖前端技术，本质是服务端 PHP 渲染行为；所谓“前端”在这里是误解——fetch() 返回的是 HTML 字符串，display() 直接输出到响应体，浏览器拿到的就是最终 HTML，不存在前端参与渲染的过程。
为什么 fetch() 没反应或空白页面
常见现象：控制器写了 return $this->fetch('index');，但浏览器返回空内容或 500 错误，控制台无报错。
-
fetch()不会自动输出，它只返回解析后的 HTML 字符串；若你没用return把它交还给框架（或手动echo），内容就丢了 - 模板路径错误时，ThinkPHP 默认静默失败（尤其在非调试模式下），不会抛异常，只会返回空字符串
- 模板文件后缀不是
.html（如用了.htm或.tpl）但未配置view_suffix，会导致找不到文件 - 模板中用了
{$var}但控制器没调用assign()赋值，变量为空不报错，但可能影响布局逻辑（比如{if $user}判定失败）
fetch() 和 display() 到底该用哪个
二者核心区别在于「谁控制输出时机」：
-
fetch('index')：纯函数式，只返回字符串，适合做中间处理（比如拼接邮件正文、生成静态页、二次过滤） -
display('index')：立即写入Response输出缓冲并结束流程，适合常规页面直出；但它会绕过框架的响应发送机制，某些中间件（如 CORS、gzip）可能失效 - 绝大多数控制器应优先用
return $this->fetch()—— 这是 ThinkPHP5 推荐方式，能保证响应生命周期完整 - 慎用
$this->display()，除非你明确需要跳过响应包装（例如导出纯文本、调试原始输出）
跨控制器/跨模块调用模板总报错
错误信息常为 Template not found 或空白，根本原因是路径解析规则被误读：
前端设计优化skill
下载
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
立即学习“PHP免费学习笔记（深入）”；
-
$this->fetch('user/edit')→ 查找view/user/edit.html（同模块内，与当前控制器无关） -
$this->fetch('admin@user/edit')→ 查找app/admin/view/user/edit.html（跨模块，@前是模块名） - 绝对路径写法：
$this->fetch(APP_PATH . 'extra/templates/login.html')，注意必须带后缀，且路径需真实存在、PHP 可读 - 别用
./或../相对路径 ——fetch()不走文件系统相对定位，只认 ThinkPHP 的模板路径规则
模板里变量不显示或乱码
不是前端编码问题，而是服务端上下文缺失或转义失控：
- 变量输出默认启用 HTML 转义：
{$name}会把<h1>变成纯文本；如需原样输出，改用{:$name}或{$name|raw} - 中文乱码大概率是模板文件本身编码不是 UTF-8 无 BOM；用编辑器另存为 UTF-8（无 BOM）格式，别信 IDE 自动识别
-
assign()传数组时，模板中访问需层级明确：$this->assign('data', ['user' => ['name' => '张三']]);，模板里写{$data.user.name}，不能漏掉data. - 调试时可临时加
{:dump($data)}查看实际传入结构，但上线前务必删掉 ——dump是调试函数，生产环境禁用
最易被忽略的一点：模板缓存。修改了 .html 文件但页面没变，不是浏览器缓存，而是 ThinkPHP 在 runtime/cache/ 下缓存了编译后的 PHP 文件。开发阶段建议关闭缓存（'template' => ['cache' => false]），或每次改完模板手动删 runtime/cache/ 目录。
