revel模板无法解析json字符串，必须在控制器中用json.unmarshal解码为go值（如map[string]interface{}）再传入；模板只支持已解码的go类型，直接传json字符串会导致渲染为空或转义输出。
Revel模板里不能直接解析JSON字符串
Go模板（包括Revel使用的html/template）本身不提供json.Unmarshal或类似运行时解析能力。你传进模板的必须是已解码的Go值——比如map[string]interface{}、[]interface{}或结构体，而不是原始JSON字节或字符串。如果模板里拿到的是"{\"name\":\"alice\"}"这种字符串，{{.name}}会报错或静默为空，因为模板引擎只认Go类型，不认识JSON语法。
常见错误现象：{{.raw_json}}在页面上直接输出一长串转义字符串，或者渲染成空；用json.Marshal再包一层导致双重编码（如"{\"name\":\"alice\"}"变成"{"name":"alice"}"）。
- 必须在控制器里完成
json.Unmarshal，把结果作为数据传入c.RenderHTML或c.Render - 不要尝试在模板中用
printf "%s" .raw_json或js函数“绕过”解析——那只是字符串拼接，不是类型转换 - 若JSON来自第三方API或文件，统一在handler里读取+解码，别丢给模板去“现场处理”
用map[string]interface{}接收任意结构JSON
当JSON字段不确定、动态变化（比如配置项、用户自定义表单数据），用map[string]interface{}最灵活。它能承载嵌套对象、数组、字符串、数字等所有基础类型，且无需预定义struct。
控制器示例：
func (c MainCtrl) ShowData() revel.Result {
raw, err := os.ReadFile("config.json")
if err != nil {
return c.RenderError("read config: " + err.Error())
}
var data map[string]interface{}
if err := json.Unmarshal(raw, &data); err != nil {
return c.RenderError("invalid JSON: " + err.Error())
}
return c.Render(data)
}
模板中可直接访问：{{.title}}、{{.features.0.name}}、{{range .items}}{{.id}}{{end}}。注意：key名区分大小写，且.items必须是切片才能range，否则会panic。
- 深层嵌套需逐级判空，例如
{{if .user.profile.avatar}}{{.user.profile.avatar}}{{end}}，避免nilpanic - 数值类型默认是
float64（JSON规范无int/float区分），需要整数显示时用{{printf "%d" .count}} - 时间字符串（如
"2026-10-19T13:48:00Z"）不会自动转为time.Time，得在控制器里提前转换好再传入
在模板里安全遍历JSON数组并传索引给子模板
Revel模板的range支持双变量解构，但必须显式声明$index和$item，且顺序不能颠倒——这对从JSON解析出的[]interface{}特别关键。
假设控制器传入data := map[string]interface{}{"tags": []string{"go", "revel", "json"}}，模板写法应为：
{{range $i, $tag := .tags}}
<div id="tag-{{$i}}">{{$.tag}}</div>
{{template "tag-item.html" $i}} // 传索引
{{end}}
关键点：
-
$i是int类型索引，$tag是当前元素（这里是string） - 子模板
tag-item.html接收的是$i值，不是整个.tags切片 - 若想同时传索引和元素，用
{{template "tag-item.html" (dict "index" $i "tag" $tag)}}（需先注册dict函数） - 别写
{{range .tags}}{{.}}——此时.是元素值，$i根本不存在，子模板收不到索引
避免RenderJSON和模板混用导致的双重序列化
一个高频陷阱：控制器本意是返回HTML页面，却误调用了c.RenderJSON(data)，结果浏览器收到的是{"name":"alice"}纯文本响应，而不是渲染后的HTML。反过来，如果数据本该走RenderJSON，却塞进RenderHTML，JSON字符串会被HTML转义（{"name":"alice"}），前端JSON.parse失败。
- 明确响应类型：HTML页面用
c.Render(data)或c.RenderHTML(data)；API接口用c.RenderJSON(data) - 检查HTTP响应头：
Content-Type: application/json对应RenderJSON，text/html对应RenderHTML - 调试时用
curl -v看实际返回内容和header，比单纯看浏览器渲染更可靠
真正麻烦的不是语法，而是数据形态的边界模糊——JSON字符串、map[string]interface{}、结构体、模板上下文这四者之间，任何一步没对齐，就会出现“看着有数据，渲染不出来”的情况。
