术语表

作用域(scope)

变量或对象可被访问的特定代码区域。

难度
参考

开始之前,你需要

  • 在文档里遇到不认识的 Hugo 术语时查阅

读完之后你能

  • 能定位模板里 undefined variable 一类报错的作用域原因,并知道变量该定义在哪一层

接着读:简介

作用域(scope)指 variable 或 object 可被访问的特定代码区域。例如,在一个 template 中初始化的变量在另一个模板中不可用。

为什么重要

变量只在定义它的作用域内可见:{{ $x := ... }} 写在 {{ if }}、{{ range }}、{{ with }} 块里,块外就读不到,partial 也不会继承调用方的变量。看到 undefined variable,或者「块内改了、块外没变」,先检查变量的定义位置;需要跨层读取时用 $ 引用外层上下文。

延伸阅读:模板简介