原生PHP模板够用于小型项目或快速原型开发，无需额外依赖、学习成本低；但不适用于复杂逻辑、嵌套循环多或需团队协作的场景。
直接用原生PHP当模板，什么情况下够用？
不需要额外安装、没有学习成本、适合快速验证逻辑或小型静态站点——原生PHP就是最轻量的“模板引擎”。但它不是万能的：一旦模板里出现大量 <?php if ($user->isAdmin): ?> 或嵌套循环，可读性会断崖式下跌，前端协作也基本归零。
关键约束点：
- 必须关闭短标签（
short_open_tag=Off），否则="hello"?>可能被服务器拒绝解析 -
include和require路径是相对当前执行文件，不是模板文件本身。比如index.php里include 'header.php'，找的是和index.php同级的header.php - 变量作用域只在当前
include文件内生效；不能在footer.php里直接访问$title，除非前面已global $title或提前extract()
Smarty 和 Twig，选哪个更不容易踩坑？
Smarty 更老、文档多、语法宽松，但默认开启缓存且编译路径容易写错；Twig 更现代、自动转义防XSS、错误提示清晰，但对 PHP 版本要求高（twig/twig:^3.0 要求 PHP ≥ 8.0）。
常见翻车现场：
立即学习“PHP免费学习笔记（深入）”；
- Smarty 的
{$name}在 CSS/JS 中遇到花括号会报错，必须包一层{literal}...{/literal} - Twig 的
{{ user.name }}如果user是null，会直接抛Twig\Error\RuntimeError，得写成{{ user?.name }}或提前判空 - 两者都禁止在模板里调用
file_get_contents()这类函数，除非显式配置白名单（Twig 需setFunction()，Smarty 需插件）
ThinkPHP 和 Laravel 的模板，为什么总找不到文件？
不是代码错，是路径规则没对上。ThinkPHP 默认按模块-控制器-操作三级匹配模板路径：app\index\controller\User.php 的 index() 方法，必须对应 app\index\view\user\index.html。Laravel Blade 则强制走 resources/views/ 下的子目录结构，return view('admin.users.index'); 对应 resources/views/admin/users/index.blade.php。
最容易忽略的细节：
- ThinkPHP 的
view_path配置值末尾不能带斜杠，写成'view_path' => './templates/'会导致路径拼接出错 - Laravel 的
@extends('layouts.app')中的layouts.app是路径别名，实际找的是resources/views/layouts/app.blade.php，不是layouts/app.blade.php - 两者都区分大小写：Linux 下
User.php和user.php是两个文件，模板路径错一个字母就Template not found
自定义分隔符和变量语法，改完为什么模板不渲染？
改定界符不是改个配置就完事。Smarty 的 tmpl_l_delim 和 tmpl_r_delim、Twig 的 setTag()、甚至 php-text-template 的构造函数参数，都只影响新加载的模板内容。已编译/缓存的模板文件不会自动重编译。
必须同步做三件事：
- 清空全部缓存目录（ThinkPHP 是
runtime/html/，Smarty 是templates_c/，Twig 是var/cache/） - 检查所有模板文件里的旧语法是否已手动替换，比如把
{$title}全局替换成 - 确认 Web 服务器对新模板目录有读取权限——尤其改了
view_path指向/opt/templates这类非项目内路径时
最隐蔽的问题：某些引擎（如 php-text-template）在构造时传入的 $openDelimiter 若含特殊字符（如 [），需确保正则转义正确，否则 render() 会静默失败，返回原始模板字符串。
