Creation:2025-04-18Last update:2025-06-29
将此文档参考到您的 AI 助手ChatGPTClaudeDeepSeekGoogle AI modeGeminiPerplexityMistralGrok
使用您最喜欢的AI助手总结文档，并引用此页面和AI提供商
将 MCP 服务器添加到您的 AI 助手
通过将 Intlayer MCP 服务器集成到您的 AI 助手，您可以直接从 ChatGPT、DeepSeek、Cursor、VSCode 等获取所有文档。
查看 MCP 服务器文档此页面的内容已使用 AI 翻译。
查看英文原文的最新版本编辑此文档
如果您有改善此文档的想法，请随时通过在GitHub上提交拉取请求来贡献。
文档的 GitHub 链接Copy
复制文档 Markdown 到剪贴板
Intlayer 中的“每语言”内容声明
Intlayer 支持两种声明多语言内容的方式：
- 单文件包含所有翻译
- 每个语言一个文件（每语言格式）
这种灵活性使得：
- 轻松迁移自其他国际化工具
- 支持自动化翻译工作流程
- 将翻译清晰地组织到独立的、特定语言的文件中
单文件多语言翻译
这种格式适用于：
- 代码中的快速迭代。
- 与内容管理系统（CMS）的无缝集成。
这是大多数使用场景推荐的方法。它将翻译集中管理，便于迭代和与 CMS 集成。
hello-world.content.ts
复制代码
复制代码到剪贴板
import { t, type Dictionary } from "intlayer";const helloWorldContent = { key: "hello-world", content: { multilingualContent: t({ en: "Title of my component", es: "Título de mi componente", }), },} satisfies Dictionary;export default helloWorldContent;推荐：当使用 Intlayer 的可视化编辑器或直接在代码中管理翻译时，此格式最佳。
按语言区域格式
此格式适用于：
- 您希望独立版本控制或覆盖翻译。
- 您正在集成机器或人工翻译工作流。
您还可以通过指定 locale 字段，将翻译拆分到单独的语言区域文件中：
hello-world.en.content.ts
复制代码
复制代码到剪贴板
import { t, Locales, type Dictionary } from "intlayer";const helloWorldContent = { key: "hello-world", locale: Locales.ENGLISH, // 重要 content: { multilingualContent: "我的组件标题" },} satisfies Dictionary;export default helloWorldContent;hello-world.es.content.ts
复制代码
复制代码到剪贴板
import { t, Locales, type Dictionary } from "intlayer";const helloWorldContent = { key: "hello-world", locale: Locales.SPANISH, // 重要 content: { multilingualContent: "Título de mi componente" },} satisfies Dictionary;export default helloWorldContent;重要提示：确保定义了 locale 字段。它告诉 Intlayer 该文件代表哪种语言。
注意：在这两种情况下，内容声明文件必须遵循命名模式 *.content.{ts,tsx,js,jsx,mjs,cjs,json}，以便被 Intlayer 识别。.[locale] 后缀是可选的，仅作为命名约定使用。
混合格式
您可以将两种声明方法结合使用于同一个内容键。例如：
- 在像 index.content.ts 这样的文件中静态声明您的基础内容。
- 在单独的文件中添加或覆盖特定的翻译，例如 index.fr.content.ts 或 index.content.json。
这种设置特别适用于：
- 您想在代码中定义初始内容结构。
- 您计划稍后使用 CMS 或自动化工具丰富或完善翻译。
bash
复制代码
复制代码到剪贴板
.└── Components └── MyComponent ├── index.content.ts ├── index.content.json └── index.ts示例
这是一个多语言内容声明文件：
Components/MyComponent/index.content.ts
复制代码
复制代码到剪贴板
import { t, type Dictionary } from "intlayer";const helloWorldContent = { key: "hello-world", locale: Locales.ENGLISH, content: { multilingualContent: "我的组件标题", projectName: "我的项目", },} satisfies Dictionary;export default helloWorldContent;Components/MyComponent/index.content.json
复制代码
复制代码到剪贴板
{ "$schema": "https://intlayer.org/schema.json", "key": "hello-world", "content": { "multilingualContent": { "nodeType": "translation", "translation": { "fr": "Titre de mon composant", "es": "Título de mi componente" } } }}Intlayer 会自动合并多语言和每个语言环境的文件。
Components/MyComponent/index.ts
复制代码
复制代码到剪贴板
import { getIntlayer, Locales } from "intlayer";const intlayer = getIntlayer("hello-world"); // 默认语言是英语，因此它将返回英语内容console.log(JSON.stringify(intlayer, null, 2));// 结果:// {// "multilingualContent": "我的组件标题",// "projectName": "我的项目"// }const intlayer = getIntlayer("hello-world", Locales.SPANISH);console.log(JSON.stringify(intlayer, null, 2));// 结果:// {// "multilingualContent": "Título de mi componente",// "projectName": "我的项目"// }const intlayer = getIntlayer("hello-world", Locales.FRENCH);console.log(JSON.stringify(intlayer, null, 2));// 结果:// {// "multilingualContent": "Titre de mon composant",// "projectName": "我的项目"// }自动翻译生成
使用 intlayer CLI 根据您偏好的服务自动填充缺失的翻译。
文档历史
- 5.5.10 - 2025-06-29：初始化历史