Revel 框架不支持手动使用 html/template；它在启动时封装并接管模板生命周期，自动加载视图、注入上下文、绑定表单函数、支持布局嵌套与 XSS 转义，手动调用将绕过全部机制。

Revel 框架**不直接使用标准库的 html/template 实例进行手动解析和执行**——它在启动时已封装并接管了整个模板生命周期。你不能也不该在控制器里调用 template.ParseFiles 或 t.Execute；所有模板渲染由 Revel 自动完成，你只需按约定写好 .html 文件、传入数据、用对内置函数。

为什么不能自己 new html/template 并 Execute？

Revel 的模板系统是深度集成的：它自动加载 app/views/ 下文件、注入上下文（如 .Errors、.Flash）、绑定 field 表单辅助函数、支持 {{yield}} 布局嵌套，并在渲染前统一做 XSS 安全转义。手动创建 html/template 实例会绕过所有这些机制：

• 表单校验信息（c.Validation.Error("x")）不会注入到 $field.Error
• {{set}}、{{append}} 等 Revel 特有函数不可用
• 布局继承（{{template "layouts/main.html" .}}）失效
• 错误页（如 404.html）配置完全不生效

Revel 模板实际用的是 html/template 吗？

是的，但被封装了。Revel 底层确实基于 html/template，并做了三件事：

• 所有输出默认走 html/template 的上下文感知转义（

  {{.Name}}

  

  财经HTML高端海报生成

  复杂得财经如何变成清晰，适合手机看的海报？如何加上你的IP

  下载
  → 自动转义 HTML；@#@#@#@#@#@#@#@#@#@0 → 按 URL 规则转义）
• 禁用了不安全操作：比如不允许直接 {{.RawHTML | safeHTML}}，除非你显式注册自定义函数并确认风险
• 重写了 FuncMap，把 eq、field、radio 等注入到每个模板作用域

所以你写的 {{.User.Name}} 看似简单，背后是 html/template 在严格上下文中执行转义——你无需操心，但也不能跳过 Revel 的约定去“直连”原生 API。

哪些地方会意外触发原生 html/template 行为？

最容易踩坑的是在自定义模板函数里误用：

• 若你在 app/init.go 中注册函数，返回值是 template.HTML 类型（如 return template.HTML("ok")），Revel 会信任它不转义——这等同于原生 html/template 的 safeHTML，但需确保内容绝对可信
• 用 {{include "partials/_nav.html" .}} 时，被 include 的文件仍受同一套 html/template 转义规则约束；但若你在其中写 {{.Raw}} 且 .Raw 是字符串而非 template.HTML，它仍会被转义
• {{range .Items}} 遍历时，. 指向当前元素——这点和原生 html/template 一致，但 Revel 不支持 {{$i, $v := range .Items}} 这种双变量语法，必须用 {{range $i, $e := .Items}}（$i 是索引，$e 是元素）

真正关键的不是“怎么用 html/template”，而是“怎么让 Revel 正确用它”——路径、命名、字段名、field 的 Validation 绑定，错一个环节，html/template 就只能安静地渲染出空字符串或默认值，连 warning 都不报。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！