TP 8.1.0 中 {volist} 属性名错误会导致静默失效而非报错，需通过查看 runtime/template 下编译后的 PHP 文件确认是否生成循环逻辑，并严格使用小写 key/id、合法变量名，避免嵌套超限与非法语法。
TP 8.1.0 中 {volist} 标签属性名写错，通常不会报错，而是静默跳过整个循环块——页面空白、数据不渲染、empty 也不显示。这不是运行时错误，而是模板编译阶段的解析失败，所以靠 var_dump 或浏览器控制台看不到原因。
看编译后的 PHP 文件定位真实问题
ThinkPHP 模板在首次访问时会把标签编译成原生 PHP 代码，存放在 runtime/template/ 下的子目录中（文件名含哈希）。直接打开对应缓存文件，搜索 foreach 或 while，如果没看到循环逻辑，说明 {volist} 根本没被正确解析——大概率是属性名拼错或大小写不对。
- 确认
config/template.php中开启可读缓存：'compile_type' => 'file'，且'strip_space' => false - 清空
runtime/template/目录，刷新页面，再进缓存文件查看生成结果 - 重点检查：是否用了
KEY、index、i等非标准属性名（TP 8.1 只认 key 和 id）
属性名大小写与拼写必须严格匹配
TP 8.1 对 {volist} 属性名完全大小写敏感，且只识别有限关键词：
- ✅ 正确：
{volist name="list" id="vo" key="k"} - ❌ 无效（静默失效）：
{volist name="list" KEY="k"}、{volist name="list" index="k"}、{volist name="list" i="k"} - ⚠️
id值必须是合法 PHP 变量名：不能含点（.）、中划线（-）、空格，否则后续如$vo.status会被误拆为两个变量，导致解析中断
嵌套标签内避免变量名冲突和深度超限
在 {volist} 里嵌 {if}、{eq} 等标签时，容易因作用域残留或层级限制失效：
- 确保闭合顺序严格匹配：
{volist} → {if} → {/if} → {/volist}，混用{/foreach}会导致整个块被丢弃 - 默认模板解析深度为 3 层（
template.taglib_level = 3），若嵌套超过三层（如 volist → if → volist → eq），超出部分静默跳过 -
{eq name="vo.status" value="$v.title"}这类写法危险：双大括号{$v.title}在标签内部会被二次解析，变成<?php echo $v.title; ?>嵌套在 PHP 标签里，直接语法报错；应改用value="$v['title']"（无花括号）
启用 Trace 日志而非依赖 dump
模板解析发生在编译期，不是 PHP 运行时，所以 dump()、echo 都看不到解析过程。真正有效的调试方式是开启 trace：
- 在
config/app.php中确保'app_debug' => true - 访问页面后，在底部调试栏切换到「Trace」→「Template」面板，查看模板加载、编译、缓存路径等完整链路
- 若发现某模板未出现在 trace 的「Compiled」列表中，说明它压根没通过解析，问题就在标签语法本身
