先说个核心判断：JSON 存语言包比硬编码更可控

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

用 JSON 文件存语言包比写死在 HTML 里更可控

直接把多语言文本硬塞进每个 或

标签里会怎么样？结果就是，想改个语言就得把整个 HTML 翻个底朝天，后期的维护简直就是场灾难。一个更聪明的办法，是把每种语言的文案都抽出来，变成独立的 JSON 文件。比如，建立 locales/zh.json、locales/en.json，用清晰的键值对来管理：

{
  "header_title": "欢迎来到我们的网站",
  "btn_submit": "提交"
}

这么一来，切换语言就变成了简单地加载对应的 JSON 文件，然后批量更新页面上的内容。整个过程不依赖后端，也无需刷新页面，纯前端就能轻松搞定，灵活性和可控性一下子就上来了。

用 data-i18n 标记需要翻译的元素最轻量

实现这个功能，其实不必引入那些庞大的 i18n 库。只需要给需要翻译的 HTML 标签加上一个自定义属性就行，比如：

• 像 input 的 value 这类属性，不能直接用 data-i18n，需要额外用 setAttribute('value', ...) 来处理。
• placeholder、alt、title 这些属性也需要单独遍历处理，不能指望通用的 textContent 赋值。
• 如果页面里有动态生成的 DOM 元素（比如用 Ja vaScript 弹出的窗口），记得在元素插入后，要手动调用一次翻译函数，否则它们可不会自动变语言。

localStorage 记住用户上次选的语言，但别跳过初始 fallback

用户体验的关键在于“记忆”。用户这次选了日语，下次打开网站时，理应直接看到日语界面——这个功能靠 localStorage.setItem('lang', 'ja') 就能实现。但这里有个陷阱：首次访问时，localStorage 里空空如也，如果没有一个靠谱的兜底方案，页面可能一片空白。一个稳健的加载逻辑应该是这样的：

话说回来，处理语言切换就像准备一份备用计划，必须层层设防。

• 首先，尝试读取 localStorage.lang，看看用户有没有历史选择。
• 如果没找到，就退而求其次，检查浏览器的语言设置 na vigator.language（注意：Safari 可能返回 zh-CN，而你的语言文件可能叫 zh.json，这里需要做字符串截断或映射处理）。
• 如果以上都失败了，那就强制降级，回退到像 en.json 这样的主要语言文件。

忽略这个 fallback 机制？那么当遇到一个你未精准支持的语言变体（比如只有 zh.json 却来了个 zh-HK 的请求）时，整个页面的文案都可能消失不见，这体验可就糟透了。

静态站点生成时预编译多语言 HTML 更快，但失去运行时灵活性

对于使用 Hugo、Jekyll 或 VuePress 这类静态站点生成器的项目，还有另一条路：在构建时就直接生成多套 HTML 文件，比如 /zh/index.html 和 /en/index.html。这么做的优势很明显——首屏加载速度极快，对搜索引擎（SEO）也非常友好。但代价则是牺牲了灵活性：切换语言通常意味着整页跳转（例如从 /en/contact 跳到 /zh/contact），而且所有页面的路径结构必须严格对应。在这种情况下，URL 的设计和 这类标签就变得至关重要，否则搜索引擎很可能将其误判为重复内容。

真正的挑战往往来自混合场景。页面上有些文案（比如用户昵称、动态时间格式）必须在运行时确定，而有些（比如 SEO 标题）又必须在构建时就固定下来。这时候，企图用一个 JSON 文件解决所有问题是不现实的。明智的做法是把静态内容和动态内容拆分开来处理，各司其职，才能游刃有余。