开始使用 Intlayer 和 Express 进行国际化 (i18n)

express-intlayer 是一个强大的国际化 (i18n) 中间件，适用于 Express 应用程序，旨在通过根据客户端的偏好提供本地化响应，使您的后端服务在全球范围内可访问。

为什么要国际化您的后端？

国际化您的后端对有效服务全球受众至关重要。它使您的应用能够以每个用户的首选语言传递内容和消息。这种能力改善了用户体验，并通过使其对来自不同语言背景的人们更可访问和相关，从而扩大了您应用的覆盖范围。

实际使用案例

• 以用户语言显示后端错误：当发生错误时，以用户的母语显示消息可以改善理解并减少挫败感。这对可能在前端组件（如 Toast 或模态框）中显示的动态错误消息特别有用。

• 检索多语言内容：对于从数据库中提取内容的应用程序，国际化确保您可以以多种语言提供此内容。这对于需要以用户首选语言显示产品描述、文章和其他内容的电子商务网站或内容管理系统至关重要。

• 发送多语言电子邮件：无论是交易电子邮件、营销活动还是通知，以接收者的语言发送电子邮件可以显著提高参与度和有效性。

• 多语言推送通知：对于移动应用程序，以用户首选语言发送推送通知可以增强互动和留存。这种个性化的方式可以使通知感觉更加相关和可操作。

• 其他通信：来自后端的任何形式的通信，例如 SMS 消息、系统警报或用户界面更新，都从使用用户的语言中受益，以确保清晰度并增强整体用户体验。

通过国际化后端，您的应用不仅尊重文化差异，还更好地适应全球市场的需求，使其成为在全球范围内扩展服务的关键步骤。

开始

安装

要开始使用 express-intlayer，请使用 npm 安装该包：

npm install intlayer express-intlayer

设置

通过在项目根目录中创建 intlayer.config.ts 来配置国际化设置：

import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  internationalization: {    locales: [      Locales.CHINESE,      Locales.FRENCH,      Locales.SPANISH_MEXICO,      Locales.SPANISH_SPAIN,    ],    defaultLocale: Locales.CHINESE,  },};export default config;

Express 应用程序设置

设置您的 Express 应用以使用 express-intlayer：

import express, { type Express } from "express";import { intlayer, t } from "express-intlayer";const app: Express = express();// 加载国际化请求处理程序app.use(intlayer());// 路由app.get("/", (_req, res) => {  res.send(    t({      en: "Example of returned content in English",      fr: "Exemple de contenu renvoyé en français",      "es-ES": "Ejemplo de contenido devuelto en español (España)",      "es-MX": "Ejemplo de contenido devuelto en español (México)",      zh: "返回内容的示例使用中文",    })  );});// 启动服务器app.listen(3000, () => console.log(`Listening on port 3000`));

兼容性

express-intlayer 与以下完全兼容：

• react-intlayer 适用于 React 应用程序
• next-intlayer 适用于 Next.js 应用程序
• vite-intlayer 适用于 Vite 应用程序

它也与各种环境中的任何国际化解决方案无缝协作，包括浏览器和 API 请求。您可以自定义中间件以通过请求头或 Cookie 检测语言：

import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  // ... 其他配置选项  middleware: {    headerName: "my-locale-header",    cookieName: "my-locale-cookie",  },};export default config;

默认情况下，express-intlayer 将解析 Accept-Language 请求头以确定客户端的首选语言。

要获取有关配置和高级主题的更多信息，请访问我们的 documentation。

Powered by TypeScript

express-intlayer 利用 TypeScript 的强大功能来增强国际化过程。TypeScript 的静态类型确保每个翻译键都得到了处理，从而降低了错过翻译的风险并改善可维护性。

确保生成的类型（默认情况下在 ./types/intlayer.d.ts）包含在您的 tsconfig.json 文件中。