ThinkPHP模板变量为空_Assign赋值与模板输出检查技巧-ThinkPHP-PHP中文网

{$name}不显示但dump能输出，根本原因是tp模板默认html转义且空值被静默忽略；应使用{: $name}验证，检查assign是否赋null/空字符串、编码bom、同名覆盖及think变量依赖环境等问题。

thinkphp模板变量为空_assign赋值与模板输出检查技巧

模板里 `{$name}` 不显示，但 `dump($name)` 能打出值

这是最常见的“变量存在却渲染不出来”问题，根本原因不是没赋值，而是 ThinkPHP 模板引擎默认对输出做了 HTML 实体转义，且空字符串、null、false、0 在模板中直接输出时会被静默忽略（尤其在未加判断的简单输出场景）。

实操建议：

用 {: $name} 替代 {$name} 绕过自动转义和空值过滤，快速验证是否是转义/空值逻辑干扰
检查控制器中是否用了 $this->assign('name', null) 或 $this->assign('name', '') —— 这两种值在模板里用 {$name} 输出就是“看不见”，但它们确实存在
确认模板文件编码为 UTF-8 无 BOM，BOM 会导致输出前置空白，有时被浏览器截断或 CSS 隐藏

`$this->assign()` 多次同名赋值后模板只显示最后一次

ThinkPHP 的 assign() 是覆盖式写入，不是合并。如果在控制器里先后调用了两次 $this->assign('data', $a) 和 $this->assign('data', $b)，模板中 {$data} 只能取到 $b 的值。

容易踩的坑：

在中间件、父类控制器、钩子方法中悄悄执行了同名 assign()，覆盖了你本意要传的值
使用 $this->view->assign()（V6.1+）和 $this->assign() 混用，二者作用域不同，后者仅对当前操作生效，前者可能跨操作残留
在循环中反复 assign() 同一个键名，误以为能累积数据，实际只是不断覆盖

模板中 `{$Think.get.xxx}` 或 `{$Think.post.xxx}` 突然不工作

ThinkPHP 模板内置的 {$Think.*} 变量（如 {$Think.get.id}）依赖运行时环境注入，不是控制器 assign() 的结果。一旦开启 URL 路由重写、使用 CLI 模式、或模板被单独渲染（如 View::instance()->fetch()），这些变量就不可用。

为什么这样做：

{$Think.get.xxx} 底层读的是 $_GET，但会受 Request 对象当前绑定状态影响；URL 路由解析后，原始 $_GET 可能已被清空或重映射
V6.0+ 默认关闭了 think_template 的自动注入开关，需手动在配置中设 'tpl_replace_string' => ['__PUBLIC__' => '/public'] 并确保 think\template\driver\File 正常加载
更稳妥的做法是：在控制器中显式 $this->assign('get_id', input('get.id'))，再在模板用 {$get_id}

模板变量输出时出现 `Notice: Undefined variable`

这个错误不是模板语法报的，而是 PHP 自身在开启 E_NOTICE 时，对未定义变量的警告。ThinkPHP 模板编译后生成的 PHP 文件里，如果写了 {$user.name} 但 $user 根本没被 assign() 过，就会触发该提示。

关键点：

ThinkPHP 不会主动拦截或静默处理未定义变量访问，它把责任交还给 PHP 运行时
开发环境应保持 error_reporting(E_ALL)，这样能早发现问题；线上环境建议关闭 display_errors，但保留日志记录
避免写 {$user.profile.avatar} 这种深层访问，改用 {: !empty($user['profile']['avatar']) ? $user['profile']['avatar'] : ''} 或 V6.1+ 的空合并语法 {$user.profile.avatar ?: 'default.png'}

最常被忽略的是：模板继承结构中，子模板用了父模板没 assign() 的变量，或者 {include file='xxx'} 时没同步传参。这种问题不会报错，但输出为空，排查起来比报错更费时间。