translate.js是最快落地的国际化方案,适合静态HTML商品页,两行脚本即可自动识别并翻译为浏览器语言,无需改结构、不依赖语言文件、不破坏DOM和SEO。

直接用 translate.js 是最快落地的方案,尤其适合已有静态 HTML 商品页、不想改结构、不希望加后端逻辑的场景。它不依赖语言文件、不碰 DOM 结构、不改数据流,两行脚本就能让整页文本自动识别并翻译成用户浏览器语言。
为什么不用自己写 i18n 逻辑?
HTML 商品详情页通常由 CMS 输出或静态生成,字段固定(如 title、desc、spec),但语言切换不是“换词典”那么简单:要处理嵌套标签里的文本、忽略按钮/图标里的占位符、保留原有 HTML 结构(比如 或链接)、还要兼容 SEO。手写 JS 遍历 + 替换容易漏掉 textContent 和 innerText 差异,也难处理 script 标签里硬编码的文案。
- 常见错误现象:
translate.execute()后部分文字没变 —— 很可能是该节点被display: none或在shadow DOM里,translate.js默认不进这些区域 - 使用场景:商品标题、参数表格、详情富文本区块、售后说明等纯展示内容;不适用于需要精准控制翻译术语(如“SSD”不能译成“固态硬盘”而要保留英文)的 B2B 页面
- 性能影响:首次执行会遍历全部
body子节点,页面超过 2000 个文本节点时可能造成轻微卡顿(可加translate.execute({ root: document.getElementById('product-desc') })限定范围)
怎么让翻译结果更可控?
translate.js 支持白名单和忽略规则,避免把价格、型号、单位等不该翻的内容误翻。关键不是禁用翻译,而是告诉它“哪些必须原样留着”。
- 加
data-no-translate属性到不想翻的元素上,比如:SKU: ABC-123 - 用
translate.ignore(['¥', 'GB', 'mm'])全局屏蔽特定字符串,防止 “128GB” 变成 “128GB(吉字节)” - 如果某段描述含多语言混合(如中英夹杂的卖点文案),建议包一层
…,translate.js会跳过带lang属性的节点
遇到翻译不准或加载失败怎么办?
它底层调用的是浏览器内置的 Intl.Translate API(Chrome 119+ / Edge 119+ 原生支持),不走外部服务,所以没有 API Key,也没有网络请求失败问题。但低版本浏览器会回退到轻量级规则匹配,准确率下降。
- 错误现象:
translate.execute()报错TypeError: translate is not a function—— 检查 script 是否 404,CDN 地址是否被墙(可换国内镜像:https://cdn.staticfile.net/translate.js/3.18.66/translate.js) - 兼容性注意:Safari 和 Firefox 当前不支持
Intl.Translate,translate.js会自动降级为基于语言检测 + 简单映射的模式,对中文→英文效果尚可,其他语向建议测试实际效果 - 调试技巧:加
translate.debug = true后刷新,控制台会打印每条文本的原始值、检测语言、目标语言和最终替换结果
真正麻烦的从来不是“怎么切语言”,而是“哪些不该切”——型号、单位、品牌名、第三方服务名这些,一旦被自动翻译就很难挽回。上线前务必用真实多语言设备访问,重点看价格栏、规格表、二维码下方提示语这三类区域。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











