环境确认与安装方式
ThinkPHP从5.0开始将模板引擎独立为topthink/think-template组件，6.x和8.x版本延续了这一设计。安装前先确认PHP版本符合框架要求，并已安装Composer。
在项目根目录执行：
composer require topthink/think-template
如果项目是通过composer create-project topthink/think创建的完整应用，模板引擎通常已内置，无需重复安装。若不确定，检查vendor/topthink目录下是否存在think-template文件夹即可。
配置视图目录与参数
模板文件默认放在view目录下，目录结构与控制器对应。例如app/controller/Index.php的index方法，对应模板路径为view/index/index.html。
如需修改默认配置，在config/view.php中调整：
return [
‘type’ => ‘Think’,
‘view_path’ => ”, // 留空使用默认view目录
‘view_suffix’ => ‘html’,
‘viewdepr’ => DIRECTORYSEPARATOR,
‘tplreplacestring’ => [],
];
多应用模式下，视图目录会按应用名自动隔离，例如app/admin/view/。
渲染模板的两种写法
控制器中继承think\Controller后，可直接使用fetch方法：
public function index()
{
return $this->fetch(‘index’, [‘name’ => ‘ThinkPHP’]);
}
不继承控制器时，使用View门面或助手函数：
use think\facade\View;
public function index()
{
return View::fetch(‘index’, [‘name’ => ‘ThinkPHP’]);
}
模板中通过{$name}输出变量，支持{$user.name}这类点语法访问数组或对象属性。
模板标签与布局
ThinkPHP模板支持{if}、{volist}、{foreach}等标签，比原生PHP更简洁。例如：
{volist name=”list” id=”item”}
{/volist}
布局功能通过{extend}和{block}实现，适合抽取公共头部、底部。在模板开头写{extend name="layout/base" /}，子模板只填写{block name="content"}区域即可。
常见报错与排查
驱动未找到：提示template not found或驱动类不存在，检查Composer是否安装成功，并执行composer dump-autoload刷新自动加载。
模板文件不存在：确认路径大小写，Linux环境区分大小写，Index和index会被视为不同文件。
编译缓存问题：修改模板后未生效，删除runtime/temp目录下的编译文件。开发阶段可关闭模板缓存，在配置中设置'tpl_cache' => false。
变量未定义：模板中输出不存在的变量会抛异常，使用{$name|default=''}设置默认值。
小结
安装ThinkPHP模板引擎只需一条Composer命令，核心在于视图目录规划与渲染方法调用。掌握fetch、模板标签和布局三部分，即可覆盖大部分日常开发场景。遇到报错优先检查路径、缓存与自动加载，基本能定位问题。
