关于网站订阅弹窗多语言化的一些优化

小吴2026-06-26 18:07:28

1. 背景

订阅弹窗原先所有文案硬编码为简体中文,在多语言站点(英文、日文等)打开时体验不一致。

本次改造目标:

  • 弹窗 UI 文案随页面语言切换

  • 站点名称在非中文环境下优先使用 API 返回的多语言名称

  • 二维码有效期、生成时间等动态文案支持本地化日期格式

  • 不增加额外构建步骤:语言包为静态 JSON,按需 fetch 加载

2.使用

部分固定文案做本地化存储

页面传入 locale即可,如果没传默认中文
后续用户只要在对应的页面打开就会自动加载所属的语言版本

降级策略

  1. 请求 {locale}.json 失败 → 自动加载 zh-cn.json

  2. zh-cn 也失败 → 使用内联 FALLBACK_MESSAGES(简体中文硬编码)

  3. 单个 key 缺失 → 回退到 FALLBACK_MESSAGES 对应 key




3. 支持语言

语言码与官微系统 language_type 保持一致,完整列表见 locales/manifest.json

语言码

说明

zh-cn

简体中文(默认)

zh

繁体中文

en

英文

jp

日文

kr

韩文

de

德文

fr

法文

es

西班牙文

pt

葡萄牙文

it

意大利文

ru

俄文

vm

越南文

th

泰文

sa

阿拉伯文

ir

波斯文

in

印地文

my

马来文

se

瑞典文

tr

土耳其文

mm

缅甸文

ua

乌克兰文

曝光4379浏览287互动1