当前位置：首页 > news >正文

在react项目中如何引入国际化

news 2025/8/5 3:25:50

react-i18next

在 React 项目中引入国际化（Internationalization，简称 i18n）可以使用第三方库来实现。其中，最常用且流行的国际化库是 react-i18next，它基于 i18next 实现，提供了方便易用的国际化功能。下面是在 React 项目中使用 react-i18next 的基本步骤：

安装依赖：

首先，在 React 项目中安装 react-i18next 和 i18next 依赖：

npm install i18next react-i18next

初始化 i18next：

在项目的入口文件（通常是 index.js 或 App.js）中初始化 i18next：

import React from 'react';
import ReactDOM from 'react-dom';
import App from './App';import { initReactI18next } from 'react-i18next';
import i18n from 'i18next';
import { nextLocal } from './nextLocals'; // 定义的语言文件i18n.use(initReactI18next).init({// 设置语言资源，可以根据需要引入其他语言文件resources: {en: {translation: {// 将所有需要国际化的文本放在这里// 例如："hello": "Hello",...nextLocal.en},},zh: {translation: {// 中文翻译// 例如："hello": "你好",...nextLocal.zh},},},lng: 'zh', // 默认语言fallbackLng: 'zh', // 如果当前语言没有对应的翻译，将使用该语言作为备用interpolation: {escapeValue: false, // 不要对翻译的文本进行转义，以支持 HTML 标签},});ReactDOM.render(<React.StrictMode><App /></React.StrictMode>,document.getElementById('root')
);

上面用到的nextLocals文件如下：

// index.tsx
import homeEn from "./Home/en.json";
import homeZh from "./Home/zh.json";export const nextLocal = {en: { ...homeEn },zh: { ...homeZh },
};// ./Home/en.json
{"home": {"hello": "Hello"}
}// ./Home/en.json
{"home": {"hello": "你好"}
}

不同页面用不同的文件夹管理，这样会更清楚。

切换语言：

可以通过 i18n.changeLanguage() 方法来在组件中切换语言。例如，可以在项目中添加一个按钮来切换语言，这里定义了一个ChangeLanguage文件，内容如下：

import React from "react";
import { Button } from "antd";
import { useTranslation } from "react-i18next";const LanguageSwitcher=()=> {const { i18n } = useTranslation();const changeLanguage = (lng: "en" | "zh") => {i18n.changeLanguage(lng);};return (<div><Buttontype="primary"style={{ marginRight: 8 }}onClick={() => changeLanguage("en")}>English</Button><Button onClick={() => changeLanguage("zh")}>中文</Button></div>);
}export default LanguageSwitcher;

使用 useTranslation 钩子：

在需要国际化的组件中，可以使用 useTranslation 钩子来获取翻译函数，并进行文本的国际化：
这里引用了上面的组件ChangeLanguage，可以点击切换语言

import React from 'react';
import { useTranslation } from 'react-i18next';
import ChangeLang from './ChangeLanguage'function MyComponent() {const { t } = useTranslation();return (<div>{/* 使用 t 函数进行国际化 */}<ChangeLang /><div style={{paddingTop: 16}}> {t('home.hello')}</div></div>);
}export default MyComponent;

react-intl-universal

使用 react-intl-universal 是另一个流行的 React 国际化库，它提供了简单易用的国际化功能。下面是在 React 项目中使用 react-intl-universal 的基本步骤：

安装依赖：

首先，在 React 项目中安装 react-intl-universal 依赖：

npm install react-intl-universal

初始化国际化资源：

在项目的入口文件（通常是 index.js 或 App.js）中初始化国际化资源：

import React from 'react';
import ReactDOM from 'react-dom';
import intl from 'react-intl-universal';
import App from './App';const locales = {en: require('./locales/en.json'), // 英文翻译文件zh: require('./locales/zh.json'), // 中文翻译文件
};const currentLocale = localStorage.getItem('language') || 'zh'; // 默认语言
intl.init({currentLocale,locales,
});ReactDOM.render(<React.StrictMode><App /></React.StrictMode>,document.getElementById('root')
);

创建翻译文件：

在项目的 src 目录下，创建一个 locales 文件夹，并在其中添加语言文件。例如，创建 en.json 和 zh.json 文件：

en.json:

{"hello": "Hello","welcome": "Welcome, {name}"
}

zh.json:

{"hello": "你好","welcome": "欢迎，{name}"
}

使用 FormattedMessage 组件：

在需要国际化的组件中，可以使用 FormattedMessage 组件来进行文本的国际化，并支持变量插值：

import React from 'react';
import { FormattedMessage } from 'react-intl-universal';const MyComponent()=> {const name = 'John';return (<div>{/* 使用 <FormattedMessage> 组件进行国际化 */}<p>{intl.get('hello')}</p><p>// 或者这么使用<FormattedMessage id="welcome" values={{ name }} /></p></div>);
}export default MyComponent;

切换语言：

您可以在项目中使用 intl.setLocale() 方法来切换语言。例如，您可以在项目中添加一个按钮来切换语言：

import React from 'react';const LanguageSwitcher = ()=> {const changeLanguage = (locale: 'en' | 'zh') => {localStorage.setItem('language',locale); // 保存window.location.reload(); // 重新加载页面};return (<div><button onClick={() => changeLanguage('en')}>English</button><button onClick={() => changeLanguage('zh')}>中文</button></div>);
}export default LanguageSwitcher;