range 和 with 会重置 . 指向当前迭代值或传入对象,$ 始终指向根数据;访问外层字段须用 $.field 或提前绑定变量(如 $name := $.name),否则渲染为空。

range 里访问外层变量为什么总是空?
因为 range 会创建新作用域,原上下文的变量(比如 .Name)在循环体内不可见,除非显式传入或用 $ 引用根对象。
-
$指向模板执行时传入的最外层数据,$.Name才能拿到循环外的字段 - 如果循环的是结构体切片,
.Field访问的是当前元素字段,不是外层数据 - 嵌套
range时,每层.都指向当前迭代值,容易误以为还在上层上下文 - 常见错误现象:
range .Items内写.Title正常,但写.SiteName(外层字段)就渲染为空
with 块内怎么安全读取原始数据?
with 也会改变 . 的指向,但它不支持像 range 那样用 $ 回溯——除非你在 with 外提前把需要的值绑定到局部变量。
- 不能依赖
$在with块里访问外层字段:Go template 的$是全局根,但with不影响它;真正的问题是开发者误以为with .User后还能直接写.Config.APIKey - 正确做法:用
{{with $.Config}}显式切换作用域,或提前用{{with $config := $.Config}}绑定别名 - 使用场景:渲染用户详情页时,
with .User简化字段访问,但页头仍需$.Site.Title,这时必须带$ - 性能无差异,但可读性差的写法(比如多层嵌套
with+ 混用.和$)会让维护者难以判断当前.到底是什么
混合使用 range 和 with 时的作用域链怎么理?
作用域不是栈式继承,而是每次 range 或 with 都重置 .,$ 始终不变——理解这点就能避免 90% 的“变量消失”问题。
- 错误写法:
{{range .Posts}}{{with .Author}}{{.Name}} / {{.Site.Title}}{{end}}{{end}}→.Site.Title报错或为空,因为with .Author后.是作者结构体,不含Site - 正确写法:
{{range .Posts}}{{with $.Site}}{{.Title}}{{end}}{{with .Author}}{{.Name}}{{end}}{{end}} - 更清晰的写法:
{{range $post := .Posts}}{{with $.Site}}{{$post.Title}} on {{.Title}}{{end}}{{end}},用$post保留当前项,避免歧义 - 注意:
range和with都不修改$,但template调用子模板时,如果没传参,子模板的.是 nil,$仍是根对象
模板里哪些值会被自动“丢掉”作用域?
函数调用返回值、管道操作结果、条件判断分支内的表达式——只要没显式赋给变量或用 $ 锚定,就只在当前语句生效。
立即学习“go语言免费学习笔记(深入)”;
-
{{if .Admin}}Hello {{.Name}}{{else}}Hi {{.GuestName}}{{end}}:两个分支的.都是原上下文,没问题 -
{{if $user := .GetUser}}{{.Name}}{{end}}:错误!$user :=是赋值,但{{.Name}}还是原.,不是$user;应写{{if $user := .GetUser}}{{$user.Name}}{{end}} - 常见坑:
{{range .Items | sort}}——sort是函数,返回新切片,range作用于它,但.在循环体内仍是每个元素,不是排序后的原始切片 - 兼容性提示:Go 1.21+ 对模板作用域检查更严格,某些过去“碰巧能用”的写法(如隐式跨作用域访问)会静默失败或渲染为空
复杂嵌套下,与其反复推导 . 和 $ 的关系,不如统一用命名绑定:{{with $data := .}}{{$data.User.Name}}{{end}} ——多敲几个字,少 debug 半小时。










