使用您最喜欢的AI助手总结文档,并引用此页面和AI提供商
通过将 Intlayer MCP 服务器集成到您的 AI 助手,您可以直接从 ChatGPT、DeepSeek、Cursor、VSCode 等获取所有文档。
查看 MCP 服务器文档此页面的内容已使用 AI 翻译。
查看英文原文的最新版本如果您有改善此文档的想法,请随时通过在GitHub上提交拉取请求来贡献。
文档的 GitHub 链接复制文档 Markdown 到剪贴板
Intlayer 文档
欢迎来到官方 Intlayer 文档!在这里,您将找到集成、配置和掌握 Intlayer 所需的一切,无论您使用的是 Next.js、React、Vite、Express 还是其他 JavaScript 环境,满足您所有的国际化(i18n)需求。
介绍
什么是 Intlayer?
Intlayer 是一个专为 JavaScript 开发者设计的国际化库。它允许您在代码中的任何地方声明内容。它将多语言内容的声明转换为结构化的字典,方便您轻松地集成到代码中。通过使用 TypeScript,Intlayer 使您的开发更加稳健和高效。
Intlayer 还提供了一个可选的可视化编辑器,允许您轻松编辑和管理内容。这个编辑器对于喜欢使用可视化界面进行内容管理的开发者,或者不想担心代码的团队来说尤其有用。
使用示例
复制代码到剪贴板
.└── Components └── MyComponent ├── index.content.cjs └── index.mjs
复制代码到剪贴板
import { t, type Dictionary } from "intlayer";const componentContent = { key: "component-key", content: { myTranslatedContent: t({ en: "Hello World", fr: "Bonjour le monde", es: "Hola Mundo", }), },} satisfies Dictionary; // 满足 Dictionary 类型export default componentContent;
复制代码到剪贴板
import type { FC } from "react";import { useIntlayer } from "react-intlayer";export const MyComponent: FC = () => { const { myTranslatedContent } = useIntlayer("component-key"); return <span>{myTranslatedContent}</span>;};
主要功能
Intlayer 提供了多种功能,专为满足现代网页开发的需求而设计。以下是主要功能,并附有详细文档链接:
- 国际化支持:通过内置的国际化支持,提升您的应用程序的全球影响力。
- 可视化编辑器:使用为 Intlayer 设计的编辑器插件,优化您的开发工作流程。请查看 可视化编辑器指南。
- 配置灵活性:通过详尽的配置选项自定义您的设置,详见配置指南。
- 高级命令行工具:使用 Intlayer 的命令行界面高效管理您的项目。探索其功能请参阅命令行工具文档。
核心概念
字典
将您的多语言内容组织在代码附近,保持内容一致且易于维护。
入门指南
学习在 Intlayer 中声明内容的基础知识。翻译
了解翻译内容如何在您的应用中生成、存储和使用。枚举
轻松管理跨多语言的重复或固定数据集。条件
学习如何在 Intlayer 中使用条件逻辑来创建动态内容。插入
了解如何使用插入占位符在字符串中插入值。函数获取
了解如何使用自定义逻辑动态获取内容,以匹配您的项目工作流程。Markdown
学习如何在 Intlayer 中使用 Markdown 创建丰富的内容。文件嵌入
发现如何在 Intlayer 中嵌入外部文件,以便在内容编辑器中使用它们。嵌套
理解如何在 Intlayer 中嵌套内容,以创建复杂的结构。
环境与集成
我们在设计 Intlayer 时充分考虑了灵活性,提供了与流行框架和构建工具的无缝集成:
- Intlayer 与 Next.js 15 集成
- Intlayer 与 Next.js 14(App Router)集成
- Intlayer 与 Next.js 页面路由集成
- Intlayer 与 React CRA 集成
- Intlayer 与 Vite + React 集成
- Intlayer 与 React Native 和 Expo 集成
- Intlayer 与 Lynx 和 React 集成
- Intlayer 与 Express 集成
每个集成指南都包含使用 Intlayer 功能的最佳实践,如 服务器端渲染、动态路由 或 客户端渲染,帮助您保持应用的高速、SEO 友好且高度可扩展。
贡献与反馈
我们重视开源和社区驱动开发的力量。如果您想提出改进建议、添加新的指南,或纠正文档中的任何问题,欢迎随时提交 Pull Request 或在我们的 GitHub 仓库 中打开 issue。
准备好更快更高效地翻译您的应用了吗? 立即深入阅读我们的文档,开始使用 Intlayer。体验一种强大且简化的国际化方法,帮助您保持内容有序,提高团队生产力。
文档历史
- 5.5.10 - 2025-06-29:初始化历史