
在 go 的 `text/template` 中,当 map 的键包含空格(如 `"name of the movie"`)时,无法直接使用点号语法(如 `.name of the movie`)访问,必须通过内置函数 `index` 显式索引。
Go 模板语言的标识符解析规则要求字段名(key)必须是合法的 Go 标识符:即以字母或下划线开头,后续仅含字母、数字或下划线,不支持空格、连字符或中文等特殊字符。因此,像 "name of the movie" 这样的键无法通过 . 语法访问(例如 {{.name of the movie}} 会编译失败)。
正确做法是使用模板内置函数 index,其签名等价于 Go 中的多级索引操作:index . "name of the movie" 表示“对当前数据(.)执行 map 查找,键为字符串 "name of the movie"”。
✅ 正确用法示例:
package main
import (
"os"
"text/template"
)
func main() {
inventory := map[string]string{
"name of the movie": "hello",
"year released": "2024",
}
tmpl, err := template.New("test").Parse("Movie name: {{index . \"name of the movie\"}}\nYear: {{index . \"year released\"}}")
if err != nil {
panic(err)
}
err = tmpl.Execute(os.Stdout, inventory)
if err != nil {
panic(err)
}
}输出:
Movie name: hello Year: 2024
⚠️ 注意事项:
- index 函数第一个参数是被索引的对象(通常为 .),后续参数为索引键(字符串字面量需用双引号包裹,且模板中双引号需转义为 \");
- 若键不存在,index 返回对应类型的零值(如 string 为 ""),不会 panic —— 可结合 if 判断安全访问;
- index 不仅适用于 map,也支持 slice/array 索引(如 {{index .Movies 0}})和嵌套结构(如 {{index . "nested" "config" "timeout"}})。
? 小技巧:若需频繁访问带空格的键,建议在传入模板前预处理数据,例如将 key 转为驼峰式(nameOfTheMovie)或添加结构体封装,提升模板可读性与健壮性。










