ThinkPHP模板变量过滤器失效主因是配置覆盖、执行顺序错误及变量未定义。需检查template.default_filter配置、避免filter()动态覆盖、显式指定嵌套变量过滤、警惕|raw取消转义、用default兜底未定义变量，并区分普通文本与富文本的过滤策略。
ThinkPHP模板中变量过滤器失效，通常不是语法写错这么简单，而是底层机制、配置优先级或执行顺序出了问题。核心要抓住三点：过滤器是否被覆盖、是否在正确上下文调用、以及变量本身是否已“解包”或未定义。
检查 template.default_filter 是否被意外清空或覆盖
TP5.1/6 中 template.default_filter 配置只影响未显式指定过滤器的 {$var} 输出，但它极易被静默覆盖：
- 确认
config/template.php中该值为'default_filter' => 'html'（TP6）或'htmlspecialchars'（TP5.1），不能是空字符串、null或html_entity_decode - 检查是否在控制器或中间件里动态调用了
View::filter()，它会覆盖全局 default_filter - 若使用了
assign()传入的是对象或数组，default_filter不会对嵌套键生效（如{$user.profile.bio}），必须显式写{$user.profile.bio|html}
过滤器顺序错误导致“绕过”转义
多个过滤器串联时，顺序决定安全边界。常见失效场景：
-
{$content|default='<script>'|html}→ 默认值里的 HTML 没被转义，直接输出 -
{$content|html|raw}→|raw会取消前面所有过滤效果，等价于未过滤 - 正确写法：
{$content|default=''|html}或更稳妥地{:$content|htmlspecialchars|default='-'}
变量未定义或已被“解包”，过滤器不触发
过滤器（包括 |html）只对存在且可读取的变量起作用。若变量根本未 assign，或已被转成数组/字符串，就会跳过过滤逻辑：
立即学习“PHP免费学习笔记（深入）”；
- 错误：
{$user.name|html}，但控制器没传$user→ 触发 PHP Notice，|html根本不执行 - 正确兜底：
{$user.name|default='匿名'|html}，default能捕获未定义状态，之后再转义 - 避免在控制器里对分页结果调用
toArray()：$list = User::paginate(10)->toArray();→ 模板中{$list|html}只处理数组字符串表示，失去原始结构和过滤上下文
富文本与普通文本混用时过滤器选错
用户提交的富文本内容（如 TinyMCE、UEditor）不能走 |html，否则会把 <p> 等合法标签也转义掉，显示为源码：
- 错误：
{$article.content|html}→ 所有标签变成文字，页面无法渲染 - 正确流程：入库前用
HTMLPurifier白名单清洗；模板中直接输出，但加|raw前必须确保已净化：{:$safe_content|raw} - 若需在富文本中插入变量（如作者名），应先净化再拼接，不要在模板里用
|html混合处理
