高效解析多语言JSON包的关键是结构扁平化设计优先，避免运行时反复解析；推荐用下划线命名扁平key（如"user_profile_edit"），或构建时拍平嵌套为点号路径映射，实现O(1)查找。
JavaScript 中加载多语言 JSON 包时，高效解析嵌套结构的关键不是“深度遍历”，而是避免运行时反复解析、按需提取、结构扁平化设计优先。语言包本身应尽量保持浅层嵌套，真正需要嵌套的场景（如带上下文的文案、复数规则、动态插值模板）再通过结构化方式支持。
语言包 JSON 结构宜扁平，嵌套仅用于语义分组
不推荐在语言包里写多层嵌套来表达逻辑关系，例如：
❌ 不推荐（增加解析负担，难维护）：{"user": {"profile": {"title": "个人资料", "edit": "编辑资料"}, "settings": {"lang": "语言设置"}}}
应改为扁平 key，用命名体现层级：
✅ 推荐（易读、易查、零解析开销）：{"user_profile_title": "个人资料", "user_profile_edit": "编辑资料", "user_settings_lang": "语言设置"}
这样翻译函数 t('user_profile_edit') 直接查表返回，无需任何递归或路径解析。
立即学习“Java免费学习笔记（深入）”；
真需嵌套结构时，用点号路径 + 缓存解析结果
若业务强制要求嵌套（如低代码平台动态渲染含 i18n 字段的 schema），可接受类似 t('form.fields.name.label') 的写法。此时解析逻辑应：
- 首次访问某 key 时，将点号路径拆解为数组
['form', 'fields', 'name', 'label'] - 在当前语言对象上逐级取值，用
for循环而非eval或with，保证性能与安全 - 缓存该路径的最终结果（如
cache['form.fields.name.label'] = '姓名'），后续调用直接命中 - 不预解析整个 JSON 树——语言包可能含上百条文案，全量遍历嵌套无意义
加载阶段就完成结构规整，而非运行时解析
更优实践是：在构建时（build time）或首次加载后，把原始嵌套 JSON “拍平”成单层 Map：
const zh = { "common": { "ok": "确定", "cancel": "取消" }, "auth": { "login": "登录" } };
// → 转为：
const flat = {
"common.ok": "确定",
"common.cancel": "取消",
"auth.login": "登录"
};
这个过程只需执行一次，之后所有 t() 调用都是 O(1) 查找。可用简单工具函数实现：
function flatten(obj, prefix = '', res = {}) {
for (let key in obj) {
const value = obj[key];
const newKey = prefix ? `${prefix}.${key}` : key;
if (value && typeof value === 'object' && !Array.isArray(value)) {
flatten(value, newKey, res);
} else {
res[newKey] = value;
}
}
return res;
}
警惕 JSON.parse 的隐性成本与错误边界
每次 fetch 加载语言包后调用 JSON.parse() 是必要步骤，但要注意：
- 确保服务端返回 Content-Type 为
application/json，避免浏览器自动编码导致中文乱码 - 加
try/catch，语言包损坏或网络截断会导致parse抛错，应 fallback 到默认语言并上报异常 - 不要在循环中反复
JSON.parse(JSON.stringify(obj))深拷贝语言包——纯浪费 CPU - 若语言包体积大（>100KB），考虑分包（如按模块拆成
common.json、dashboard.json），按需加载
