Revel 框架原生支持 i18n,但需严格遵循 messages/ 目录、INI 格式、zh-CN 等标准命名;批量导出翻译需手动解析文件,I18nFilter 按路径前缀、Accept-Language、Cookie、app.lang 顺序识别语言,且 Message 函数仅限 controller/template 中使用。

Revel 框架原生支持国际化(i18n),但它的默认机制是「按需查 key 翻译」,不是一次性导出全部翻译数据。如果你只是想在模板或控制器里用 revel.Message("login.title", nil) 渲染多语言文本,开箱即用;但若需要批量返回 JSON 格式的 key:value 翻译表(比如给前端 i18n 库用),就得绕过内置未导出的 messages 映射,自己解析文件。
消息文件格式与存放位置必须严格遵循约定
Revel 要求所有翻译文件放在 messages/ 目录下,命名规则为 模块名.语言代码(如 messages/home.en、messages/admin.zh-CN)。文件本身是 INI 格式,不支持 JSON 或 YAML:
[login.title] en = "Sign In" zh-CN = "登录" [login.submit] en = "Submit" zh-CN = "提交"
常见错误包括:
- 把文件放在
conf/messages/或app/messages/—— 必须是项目根目录下的messages/ - 语言代码写成
zh或cn—— 必须用 ISO 639-1 + ISO 3166-1 alpha-2 组合,如zh-CN、en-US、fr-FR - INI 文件里用了注释符
;但没换行或空格导致解析失败
I18nFilter 自动识别语言环境的优先级顺序
Revel 的 I18nFilter 会按以下顺序决定当前请求的语言:
- URL 路径前缀(如
/zh-CN/login,需在routes中配置:lang动态段) -
Accept-Language请求头(浏览器自动发送) - Cookie 中的
REVEL_LANG(可手动设置) - 配置项
app.lang(conf/app.conf中的 fallback)
注意:I18nFilter 不会自动重写 URL 或跳转,它只设置 c.Request.Locale 和 c.Message 函数的上下文。如果想强制语言切换并带跳转,得自己写个 action 更新 cookie 并重定向。
为跨境电子商务生成多语言、SEO 优化的产品描述。支持英语、西班牙语、俄语和阿拉伯语,并针对不同搜索引擎(Google / Bing、Yandex、中东市场)进行专项 SEO 优化。适用于以下场景:用户需为国际市场创建符合 SEO 规范的产品文案、批量生成产品描述,或针对特定搜索引擎及区域用户偏好优化内容。
批量导出翻译内容需手动解析 INI 文件
Revel 内部用 robfig/config 解析消息文件,但其维护的 messages map 是 unexported 的,无法直接访问。要实现类似 GET /api/i18n?lang=zh-CN 返回全部键值对,只能自己读取并解析:
- 用
config.ReadDefault("messages/home.zh-CN")加载单个文件(需引入github.com/robfig/config) - 遍历
messages/目录下所有匹配*.zh-CN的文件,逐个读取 section 和 key - 注意处理嵌套 key:Revel 支持
home.login.title这种点号分隔写法,但 INI 本身不原生支持嵌套,实际是靠框架层做字符串前缀匹配 - 别依赖
revel.MessageMap—— 它是测试用的 mock 工具,生产环境不可用
示例片段(简化版):
cfg, _ := config.ReadDefault("messages/home.zh-CN")
keys, _ := cfg.Options("login.title") // 获取该 section 下所有 key
for _, key := range keys {
value, _ := cfg.String("login.title", key)
// 构建 map[string]string
}
前端动态切换语言时要注意 Cookie 和路由同步
单纯改 document.cookie = "REVEL_LANG=fr-FR" 不够——下次请求虽能被 I18nFilter 识别,但前端页面不会自动刷新。常见做法是:
- 前端发请求到后端一个
SetLangaction,它调用c.SetCookie(&http.Cookie{Name: "REVEL_LANG", Value: lang, Path: "/"})并重定向回原路径 - 避免在客户端用 JS 直接操作
REVEL_LANGcookie,因为 Revel 默认只在服务端读取它 - 如果用了 URL 前缀(如
/en-US/xxx),切换语言就得拼新 URL,不能只改 cookie
最易被忽略的一点:Revel 的 Message 函数在 controller 和 template 中行为一致,但在 middleware 或异步 goroutine 里调用会 panic —— 因为没有绑定 *Controller 上下文。批量导出逻辑如果放在 filter 里,务必确认执行时机在 I18nFilter 之后,且有完整 c 实例。










