Revel模板中{{range .Map}}遍历Go原生map会乱序且不可控，因map本身无序；需在Go层预排序键为切片并传入.Keys和.Data，模板用{{range .Keys}}{{.}}{{index $.Data .}}{{end}}确保顺序。
Revel模板中直接{{range .Map}}会乱序且不可控
Go原生map遍历本身不保证顺序，Revel模板继承这一行为。直接写{{range .UserInfo}}可能每次渲染输出键值对的顺序都不同，前端无法预测，也不适合做列表序号、CSS类名拼接等依赖顺序的场景。这不是Revel的bug，而是Go语言设计使然——map是哈希表，无序是特性而非缺陷。
常见错误现象：{{range .Map}} {{.Key}}: {{.Value}} {{end}} 编译失败，因为.Map是map[string]interface{}，range无法自动解构出.Key和.Value；若强行用{{$k, $v := .Map}}，语法虽通但顺序随机，且无法控制遍历起点。
- 必须提前在Go代码中把键提取为有序切片（如
keys := []string{"name", "email", "age"}），再传入模板 - 模板里只负责按既定顺序消费，不承担排序逻辑
- 避免在模板中调用
sort.Strings或类似操作——html/template不支持
按指定顺序遍历map：用$ + index组合
当控制器传入的数据结构含两个字段：.Keys []string（已排好序）和.Data map[string]string，模板需严格按.Keys顺序取.Data对应值。关键在于range会重绑定.，所以不能写{{index .Data .}}（此时.是当前key字符串，.Data已不可达）。
正确写法是用$锚定根对象：
{{range .Keys}}
<div class="field">
<label>{{.}}</label>
<span>{{index $.Data .}}</span>
</div>
{{end}}
-
$.Data始终指向传入的原始数据结构中的Data字段 -
.在range内代表当前迭代的key（如"email"） -
index函数安全查值：key不存在时返回string零值""，不会panic
遍历map键值对并同时获取$k和$v的写法限制
如果真需要遍历整个map（非按指定顺序），只能用双变量range，但必须明确语法：{{range $k, $v := .UserInfo}}。注意：
- 变量名前必须加
$（如$k），否则在嵌套template中可能被意外覆盖 - 顺序固定为
key, value，不能写成$v, $k - 对
map[string]int，$v是int类型，可直接参与eq比较；对map[string]interface{}，$v需用printf "%v"或类型断言（但模板不支持断言，建议Go层转为具体类型） - 仍无法控制遍历顺序——这是底层决定的，别试图在模板里“修复”
nil map导致模板panic的防御写法
当.UserInfo是nil时，{{range .UserInfo}}会直接panic：nil pointer evaluating interface {}.UserInfo。空map（make(map[string]string)）可被range静默跳过，但nil不行。
安全写法必须前置判空：
{{if .UserInfo}}
{{range $k, $v := .UserInfo}}
<dt>{{.k}}</dt>
<dd>{{.v}}</dd>
{{end}}
{{else}}
<p class="empty">用户信息暂未加载</p>
{{end}}
-
{{if .UserInfo}}检查的是map是否为nil，不是长度；len(.UserInfo)在nil时也panic，不能用 - 若需区分
nil和空map，应在Go层预处理，例如传HasData: !isNil(m)作为额外标志
c.Render()之前由Go代码搞定。$和index不是技巧，是应对作用域切换的必要手段；判空不是可选项，是上线前必加的防护线。 
