Revel模板仅支持HTML注释，不支持{{/ /}}或//等语法；后者会导致编译错误，因Revel封装限制了html/template的注释功能。
Revel 模板文件（.html）本身不支持 Go 语言那种用于生成文档的 Doc 注释，也没有 // 或 /* */ 形式的可执行注释语法——你写的任何 HTML 注释（）都会原样输出到最终 HTML 中，既不参与逻辑，也不被框架解析。
模板里写注释的唯一合法方式是 HTML 注释
Revel 的模板引擎基于 Go 标准库的 html/template，它只识别标准 HTML 注释语法：。所有其他形式（如 {{/* */}}）在 Revel 0.19.0 及之前版本中**不被支持**，会直接报错 template: unexpected unclosed action。
- ✅ 正确：
- ❌ 错误：
{{/* 管理员专属区块 */}}（Revel 不识别该语法） - ❌ 错误：
// 这不是注释，会被当作文本渲染
为什么不能用 {{/* */}}？Revel 和标准 html/template 的差异
Go 原生 html/template 自 1.6 起支持 {{/* */}} 注释语法，但 Revel 在模板解析层做了封装和限制，截至 2026 年 10 月的最新稳定版（0.19.0），它仍使用较旧的模板解析器路径，显式禁用了该语法。强行使用会导致模板编译失败，错误信息为：template: …: unexpected unclosed action in command。
- Revel 的模板作用域更侧重于“安全渲染”而非“语法自由”，所以删减了非必需的语法糖
- 如果你看到社区示例用了
{{/* */}}，那大概率是混淆了纯 Gohtml/template项目与 Revel 项目 - 升级 Revel 到未来版本（如 0.20+）才可能启用，但目前无公开 roadmap 支持
模板注释的实用规范：别让注释暴露逻辑或拖慢调试
HTML 注释虽能写，但必须考虑实际影响：它会进入响应体、增加传输体积、可能泄露内部结构。因此要克制、精准、去敏感。
- 避免注释控制器逻辑细节，例如：
→ 改成 - 不要在循环块内重复写相同注释，比如每个
{{range}}项都加→ 只在{{range}}外层写一次即可 - 调试时临时加的注释（如
）上线前必须删除——Revel 不会自动过滤，且{{.Items}}可能触发 panic 或泄露数据 - 若需条件性隐藏内容（而非注释），应使用
{{if false}}...{{end}}，它完全不渲染，比注释更干净
真正容易被忽略的是：Revel 模板没有“编译期注释”概念，所有 都是运行时可见的。上线前做一次 grep -r "
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
