在 Ubuntu 环境下折腾 ThinkPHP 模板引擎，其实有不少值得注意的细节——尤其是当你从 Windows 迁移过来，或者刚接触这套框架的时候。下面把一些实用的配置、语法和调优经验整理出来，希望能帮你少走弯路。

环境与配置要点

Ubuntu 上跑 ThinkPHP，推荐组合是 Nginx + PHP-FPM，当然 Apache 也没问题。模板文件默认放在 /application/view（或者你自定义的视图目录），后缀通常是 .html。ThinkPHP 的模板引擎是编译型的——模板文件变了才会重新编译，所以开发阶段最好开启调试模式（APP_DEBUG = true），这样每次修改都会自动重新编译；生产环境就留着缓存，能省不少性能开销。

有个常见痛点：前端 JS 用的定界符跟模板标签撞车了？可以在配置里改一下定界符，比如把默认的 { } 改成 {{ }}，配置项是 'tpl_begin' => '{{', 'tpl_end' => '}}'。另外，系统变量像 $_SESSION、$_SERVER、请求变量这些，控制器里不用手动 assign，模板里直接就能用。还有安全方面，从 ThinkPHP 5.1 起，输出默认做了安全转义（类似 htmlentities），要输出原始 HTML 的话，记得用 |raw 过滤器。

常用语法与高效写法

变量输出与控制这块很基础，但组合起来很灵活。用 {$var} 输出变量，配合过滤器：{$var|raw}（不过滤）、{$var|date='Y-m-d'}、{$var|upper} 等。条件判断用 {if}{/if}，循环用 {volist}{/volist} 或 {foreach}{/foreach}。模板包含用 {include file="public/header" /}。布局和复用，推荐 {extend}{block} 组合，一套布局文件，多个页面继承定制，维护起来特别清爽。

下面给几个典型示例，都是 ThinkPHP 5/6 的常用写法，可以直接在 Ubuntu 开发环境里套用。

控制器赋值与渲染

控制器代码：

namespace app\controller;
use app\BaseController;

class UserController extends BaseController
{
    public function index()
    {
        $users = [
            ['id' => 1, 'name' => '张三', 'email' => 'zhangsan@example.com'],
            ['id' => 2, 'name' => '李四', 'email' => 'lisi@example.com'],
        ];
        $this->assign('users', $users);
        $this->assign('title', '用户列表');
        // 开发环境直接返回 fetch，框架会处理输出
        return $this->fetch('user/index');
    }
}

模板文件：app/view/user/index.html

{$title}

{volist name="users" id="u"}
    
ID: {$u.id} / 姓名: {$u.name} / 邮箱: {$u.email}
{/volist}

安全输出与 JS 冲突规避

{$data.content|raw}  {# 输出原始 HTML #}
{literal}
var name = "{$name}";
{/literal}  {# 原样输出，避免与 {{}} 冲突 #}

布局与包含

{# layout.html #}




{__CONTENT__}



{# index.html #}
{extend name="layout" /}
{block name="title"}首页{/block}
{block name="content"}
首页内容
{include file="public/header" /}
{/block}

这几个示例覆盖了变量输出、循环、包含、布局和过滤器，直接复制到项目里就能跑起来。

调试与常见问题处理

模板修改后没生效？多数时候是缓存捣的鬼。开发阶段建议开启 APP_DEBUG = true，或者手动清一下 runtime/temp 下的编译缓存。生产环境更新版本后，记得清缓存再发布。

变量未定义或者路径不对？先核对控制器里 assign 的键名跟模板中 {$key} 是不是一致，再检查 {include} 和 {extend} 的路径、区块名称有没有写错。定界符跟 JS 冲突？要么改成 {{}}，要么用 {literal}...{/literal} 把 JS 片段包起来，简单粗暴。

XSS 和富文本问题：默认输出做了转义，要原样输出富文本就用 |raw，但只对明确可信的内容这么做，否则安全风险不小。

性能与安全建议

模板层保持纯粹——别把复杂业务逻辑塞到视图里。变量尽量在控制器里统一 assign，这样测试和维护都方便。布局用 {extend}/{block} 管理，公共片段用 {include} 复用，能省下大量重复代码。

循环和嵌套别太深，太深了可读性差，性能也打折扣。遇到深层遍历，最好在控制器先把数据预处理成合适的结构。缓存策略上：开发环境关掉或弱化缓存，方便调试；生产环境打开模板编译缓存和页面输出缓存，发布新版本时顺手清掉旧缓存。

扩展与替代方案

内置模板引擎不是唯一的选项。ThinkPHP 3.x 时代很多人喜欢集成 Smarty，配置一下 'TMPL_ENGINE_TYPE' => 'Smarty'，再指定模板、编译、缓存目录就搞定了。ThinkPHP 5.1 以后也支持扩展集成其他模板组件。

从架构演进来看，ThinkPHP 从 5.0 开始越来越偏向 API 开发，模板引擎的作用在弱化。如果你的项目走前后端分离路线，完全可以让 Vue/React 接管视图层，后端只提供 JSON 接口——这样开发效率更高，扩展性也更好。