使用 localStorage 缓存 i18n 语言包可实现秒开翻译，核心是预加载+版本化 key（i18n_${locale}_${version}）+安全读写（JSON 序列化/异常捕获）+降级策略（内存缓存+fallback 文案）。
直接用 localStorage 缓存完整的 i18n 语言包（如 JSON 文件），首次加载后后续访问可跳过网络请求，实现“秒开翻译”——关键在于预加载 + 合理缓存策略 + 安全降级。
缓存语言包的完整流程
核心逻辑：页面初始化时先查 localStorage，命中则直接渲染；未命中则发起请求，成功后存入并使用；失败则 fallback 到默认语言或上次缓存。
- 语言包建议按 locale 拆分（如
zh-CN.json、en-US.json），避免单文件过大 - 缓存 key 推荐格式：
i18n_${locale}_${version}（version 可来自构建哈希或服务端 header，防止旧缓存误用） - 首次进入无缓存时，可同步显示骨架屏或默认语言文案，不阻塞 UI
安全写入与防污染处理
localStorage 只支持字符串，JSON 必须 JSON.stringify() 存、JSON.parse() 取；同时要捕获解析异常，避免因缓存损坏导致整个 i18n 失效。
- 写入前校验数据结构：确保是扁平或嵌套合法对象，不含函数、undefined、循环引用
- 读取后做
try...catch，解析失败立即清除该 key 并触发重新拉取 - 避免直接
localStorage.setItem('i18n', obj)—— 会转成[object Object]，毫无意义
自动更新与版本控制
纯 localStorage 不会自动更新。必须通过 version 字段或服务端 ETag/Last-Modified 配合判断是否需要刷新缓存。
立即学习“前端免费学习笔记（深入）”；
- 简单方案：在构建时将语言包内容哈希（如
md5(JSON.stringify(pkg))）注入 JS，作为 version 常量 - 进阶方案：请求语言包时带
If-None-Match，服务端返回 304 则不更新缓存；返回 200 则覆盖并更新 version - 用户切换语言时，优先查新 version 缓存，无则懒加载并缓存，不重复请求同一 locale
兼容性与兜底策略
localStorage 在无痕模式、iOS Safari 私密浏览下可能抛错或容量为 0；部分企业环境也会禁用。
- 封装一个
safeLocalStorage工具函数，内部 try-catch 初始化，并返回{ get, set, remove }方法 - 检测失败时自动降级到内存缓存（in-memory cache），生命周期仅限当前会话
- 对关键文案（如按钮文字、错误提示）保留最小 fallback 映射表，即使缓存和网络都不可用也不白屏
不复杂但容易忽略：缓存不是一劳永逸，重点在可控、可测、可退。真正实现秒开，靠的是预判用户语言、静默更新缓存、以及出错时不连锁崩溃。
