根本原因是Volt默认不自动透传变量给子模板，需显式处理：include共享父变量，partial必须with传参；检查控制器赋值、拼写、路径及缓存。

Phalcon 中使用 Volt 模板时，子模板（如 include 或 partial 引入的文件）读不到变量，根本原因不是“没传”，而是变量作用域未自动继承或传递路径不明确。Volt 默认不会把父模板的所有变量自动透传给子模板，必须显式处理。

确认变量是否真正到达父模板

先排除源头问题：控制器传值是否生效？

• 用 $this->view->setVar('name', 'Tom') 或 $this->view->setVars(['name' => 'Tom']) 明确赋值
• 避免只靠 assign() 或自定义方法名（Phalcon 不识别 ThinkPHP 风格的 assign）
• 在父模板中加 {{ name }} 测试能否输出 —— 若这里都为空，说明控制器传值失败，需检查 action 是否执行、路由是否匹配

子模板中正确访问变量的三种方式

Volt 的 {% include %} 和 {% partial %} 行为不同，变量传递逻辑也不同：

• 用 {% include 'sub.volt' %}：子模板共享父模板全部变量，无需额外操作 —— 但前提是父模板已定义该变量且未被覆盖
• 用 {% partial 'sub.volt' %}：默认不继承变量，必须显式传参，例如：
  {% partial 'sub.volt' with ['user' : user, 'items' : items] %}
• 在子模板内主动调用 parent 上下文（不推荐）：Volt 不支持类似 Twig 的 parent() 变量继承机制；依赖作用域穿透是不可靠的

常见陷阱与修复操作

以下情况极易导致“读取不到”，但修复非常直接：

• 拼写错误或大小写不一致：Volt 区分大小写，{{ User.name }} 和 {{ user.name }} 是两个变量；检查控制器传的是 'user' 还是 'User'
• 数组/对象属性访问语法错误：Volt 中访问对象属性用 obj->prop，访问数组键用 arr['key'] 或 arr.key（仅限合法键名）；避免混用 PHP 风格的 $obj->prop
• 子模板路径错误：确保 sub.volt 文件真实存在于 app/views/ 对应路径下；Volt 不报错，只是静默跳过不存在的模板
• 缓存未刷新：若启用了 Volt 编译缓存（如 path 选项），修改变量后需清空 compiled-templates/ 目录，否则旧编译结果仍运行

调试建议：快速定位在哪一层断掉

在父模板顶部加：

{% set debug = {'user': user, 'items': items} %}<br>{{ dump(debug) }}

再在子模板开头同样加 {{ dump(debug) }}，对比输出即可判断是传值中断，还是子模板本身未加载。