讲师中心 微信公众号
AI工具推荐 视频效率加速

javascript国际化如何支持_怎样实现多语言和本地化【教程】

阿婷同学_6343

阿婷同学_6343

发布时间:2026-01-31 16:32:37

|

512人浏览过

|

来源于php中文网

原创

JavaScript国际化需自行管理翻译资源并用Intl API格式化,语言包动态加载、标准BCP 47代码、显式切换UI+持久化、locale与翻译一致、避免硬编码格式、安全处理插值与复数。

javascript国际化如何支持_怎样实现多语言和本地化【教程】

JavaScript 国际化(i18n)本身不内置多语言支持,Intl API 只负责格式化(日期、数字、货币、排序),不处理翻译文本。要实现真正的多语言切换和本地化,必须自己管理翻译资源 + 用 Intl 做格式化适配。

怎样加载和切换语言包

核心是维护一个语言键值映射对象,并在运行时动态替换。不能依赖浏览器自动识别语言后就“开箱即用”,需要显式加载对应语言的 JSON 文件或模块。

  • 推荐用 ES 模块动态导入:import(`./locales/${lang}.js`),避免打包时全量引入
  • 如果用 JSON,需注意跨域限制:放在同源静态目录下,或由后端返回;直接 fetch('./locales/zh.json') 是常见做法
  • 语言代码要用标准 BCP 47 格式(如 zh-CN、en-US),别用 zh 或 english 这类非标准写法,否则 Intl 格式化可能降级或出错
  • 切换语言后,所有已渲染的文本不会自动更新——必须手动触发重渲染(React/Vue 中响应式更新;原生 JS 需重新赋值 textContent 或 innerHTML)

为什么不能只靠 navigator.language

navigator.language 返回的是用户系统/浏览器首选语言,但实际业务中它不可靠:

  • 用户可能用英文系统但需要中文界面(比如海外华人)
  • 企业内网环境常被策略强制设为英文,但员工需本地语言
  • 移动端 WebView 下该值可能固定为宿主 App 语言,与用户设置脱节
  • 隐私模式或某些浏览器扩展会屏蔽或伪造该值

正确做法是:以 navigator.language 作默认 fallback,但必须提供显式语言切换 UI(如顶部语言下拉),且将用户选择持久化到 localStorage 或 cookie。

React Wrap
React Wrap

React UI?—— JavaScript?

下载

立即学习“Java免费学习笔记(深入)”;

日期/数字/货币格式怎么随语言自动变

这部分才是 Intl 的强项,但要注意 locale 参数必须和语言包一致,否则格式和文案会错位。

  • 日期格式:new Intl.DateTimeFormat('ja-JP').format(new Date()) → "2024/06/12";用 'de-DE' 就变成 "12.06.2024"
  • 数字分组:new Intl.NumberFormat('en-US').format(1234567) → "1,234,567";'zh-CN' 是 "1,234,567"(注意:中国也用千分位,但小数点是点)
  • 货币符号位置、分隔符、小数位数都由 locale 决定:new Intl.NumberFormat('fr-FR', { style: 'currency', currency: 'EUR' }).format(123.45) → "123,45 €"
  • 切勿硬编码格式逻辑(比如 “把小数点换成逗号”),所有格式化必须走 Intl,否则无法覆盖阿拉伯语等从右向左(RTL)场景

常见坑:翻译键嵌套、复数、占位符怎么处理

纯扁平 key(如 login.title)容易维护,但遇到复数、性别、上下文差异时就会力不从心。

  • 简单插值可用模板字符串:`${t('welcome')}, ${name}`,但要防 XSS —— 若 name 来自用户输入,必须先做 HTML 转义或用 textContent
  • 复数规则不能靠 if 判断数量,要用 Intl.PluralRules:new Intl.PluralRules('ru-RU').select(count) 返回 'one' / 'few' 等,再查对应翻译
  • 嵌套结构(如 { user: { profile: { title: '个人资料' } } })会让 key 路径变长,建议用函数封装访问:t('user.profile.title') 内部按点分割取值,比手写 dict.user.profile.title 更健壮
  • 不要在翻译文本里塞 HTML 标签(如 "点击<a href="https://www.php.cn/link/263b1243ca2dbeb358777ceabc4a2e4c">这里</a>继续"),应拆成带占位符的结构:t('click_here_to_continue', { link: '<a href="https://www.php.cn/link/263b1243ca2dbeb358777ceabc4a2e4c">这里</a>' }),再用安全方式插入

真正难的不是加载几个 JSON,而是让格式化、复数、RTL、字体渲染、日期计算全部对齐同一 locale,且不和业务状态耦合。很多项目卡在“中英文能切,日文时间一显示就乱码”,问题往往出在 locale 字符串传错了,或者用了 en 却期待日本格式。

相关文章

java速学教程(入门到精通)
java速学教程(入门到精通)

java怎么学习?java怎么入门?java在哪学?java怎么学才快?不用担心,这里为大家提供了java速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2195

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3462

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1156

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3979

2025.09.10

counta和count的区别
counta和count的区别

Count函数用于计算指定范围内数字的个数,而CountA函数用于计算指定范围内非空单元格的个数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3428

2023.11.20

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1769

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1211

2024.06.27

cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

12239

2023.06.30

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

20

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app快速上手
uni-app快速上手

共0课时 | 0人学习

Vue 教程
Vue 教程

共42课时 | 17.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn