根本原因是Revel默认用text/plain响应头返回HTML,浏览器按ISO-8859-1解析UTF-8中文;须在AppInit中通过revel.InterceptFunc在BEFORE阶段全局设置Content-Type: text/html; charset=utf-8,并确保模板为UTF-8无BOM、数据库连接启用utf8mb4。

Revel模板输出中文乱码的直接原因
根本不是模板文件本身编码问题,而是Revel默认用text/plain响应头返回HTML内容,浏览器按ISO-8859-1解析,导致UTF-8编码的中文显示为乱码。你改了.html文件保存为UTF-8无BOM也没用——响应头没告诉浏览器“这是UTF-8”。
必须在AppInit中设置全局Content-Type
Revel不自动设置text/html; charset=utf-8,得手动干预响应头生成逻辑。在app/init.go的init()函数里,加这段注册代码:
revel.InterceptFunc(func(c *revel.Controller, fc revel.FilterChain) revel.Result {
c.Response.Out.Header().Set("Content-Type", "text/html; charset=utf-8")
return fc.Next(c)
}, revel.BEFORE, &revel.InterceptMethod{Controller: "*"})
- 不能只在某个Controller里设,因为模板渲染发生在Filter链早期,必须BEFORE阶段拦截
- 别用
revel.Intercept带结构体的方式,容易漏掉静态资源或错误页 - 如果用了自定义
Render方法,也要确保它没覆盖这个Header
模板文件和Go源码的编码确认要点
虽然响应头是主因,但这两处错也会让乱码“雪上加霜”:
-
.html模板文件必须存为UTF-8无BOM(VS Code右下角点编码→“Save with Encoding”→UTF-8) - Go源码中硬编码的字符串(比如
c.RenderArgs["title"] = "用户管理")本身是UTF-8,无需额外处理,但别用gob或旧版json包序列化含中文的struct,它们可能触发隐式编码转换 - 如果模板里有
{{.Title}}且Title来自数据库,确认DB连接配置了charset=utf8mb4(MySQL)或等效参数
验证是否生效的快速检查法
别只看页面显示,直接看网络响应头和原始响应流:
- Chrome开发者工具→Network→点HTML请求→Headers→Response Headers→确认有
Content-Type: text/html; charset=utf-8 - Response标签页里右键“View source”,看原始字节:中文应显示为可读文字,而不是
你好或一堆 - curl -I http://localhost:9000/ 看响应头,避免浏览器缓存干扰
最常被忽略的是Interceptor注册时机和范围——漏掉&revel.InterceptMethod{Controller: "*"}会导致404页面或静态资源仍走默认头,一并乱码。











