跳转到主内容
新派编程网 - 新潮编程理念,全新技术课堂!

如何在 Go 的 html/template 中正确传递并使用基础变量

go 的 ` html /template` 包支持直接向模板传入基础类型(如 string、int、bool)或 map,只需在模板中通过 `.key` 语法访问 map 中的字段即可。 在 Go 模板中,.(点号)代表当前 作用域 的数据上下文(即传入 ExecuteTemplate 的数据)。当传入的是一个 map[string]interface{} 时,模板可通过 {{.keyName}} 的形式访问其键值——这是最常用且推荐的方式,无需封装为结构体。 以下是一个完整可运行的示例:
package main import ( "html/template" "log" "net/http" "os" ) func main() { // 方式一:从字符串解析模板(适合演示) tmplString := `{{define "index"}} {{.var1}} is equal to {{.var2}} {{end}}` tmpl, err := template.New("index").Parse(tmplString) if err != nil { log.Fatal(err) } // 构造纯变量映射 data := map[string]interface{}{ "var1": "value", "var2": 100, "isActive": true, } // 输出到标准输出(演示用) err = tmpl.ExecuteTemplate(os.Stdout, "index", data) if err != nil { log.Fatal(err) } // 方式二:Web 服务中实际使用(搭配 http.Handler) http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) { w.Header().Set("Content-Type", "text/html; charset=utf-8") if err := tmpl.ExecuteTemplate(w, "index", data); err != nil { http.Error(w, err.Error(), http.StatusInternalServerError) } }) log.Println("Server starting on :8080") log.Fatal(http.ListenAndServe(":8080", nil)) }
✅ 关键要点说明 : 模板中必须使用 {{.var1}} 而非 {{var1}} —— 缺少前导 . 将导致模板编译失败或渲染为空(因未找到根作用域下的变量名); . 可嵌套使用,例如 {{.User.Name}}(当 data["User"] 是结构体或 map 时); 若需传入单个基础值(如仅一个字符串),可直接传 "hello",并在模板中用 {{.}} 访问其本身(此时 . 即该字符串); 所有传入数据均需满足 Go 模板的安全规则(如自动 HTML 转义),敏感内容可使用 {{.RawHTML | safeHTML}}(需提前调用 template.HTML 类型转换)。 ⚠️ 注意事项 : 使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件 如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Andr​​oid友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Andr​​oid应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更 下载 立即学习 “ 前端免费学习笔记(深入) ”; 避免在模板中硬 编码 未声明的 key(如 {{.missing}}),会导致运行时静默为空,建议配合 template.Must() 和单元测试验证; 使用 map[string]interface{} 灵活但缺乏类型安全;对复杂场景,建议定义明确结构体并导出字段(首字母大写)以提升可维护性与 IDE 支持。 掌握 . 的作用域机制,是高效使用 Go 模板的基础——它让变量传递简洁直观,无需冗余包装。

相关文章