Creation:2025-09-22Last update:2025-09-22
将此文档参考到您的 AI 助手ChatGPTClaudeDeepSeekGoogle AI modeGeminiPerplexityMistralGrok
使用您最喜欢的AI助手总结文档，并引用此页面和AI提供商
此页面的内容已使用 AI 翻译。
查看英文原文的最新版本编辑此文档
如果您有改善此文档的想法，请随时通过在GitHub上提交拉取请求来贡献。
文档的 GitHub 链接Copy
复制文档 Markdown 到剪贴板
新版 Intlayer v6 - 新特性介绍
欢迎使用 Intlayer v6！本次发布重点提升了性能、开发者体验和可靠性。以下是主要亮点，包括迁移说明和可复制粘贴的示例。
亮点
- 新命令：
npx intlayer content test用于检测缺失的翻译 - 新增全局
autoFill选项，用于自动生成缺失的翻译 - 填充命令默认跳过已有翻译：
npx intlayer fill - VS Code 扩展：新增 Intlayer 活动栏（搜索和词典）、工具栏/上下文操作、自动显示、填充/测试命令
- 通过 Promise 并行化实现构建速度提升 10 倍
- 远程词典缓存，避免应用启动时重复获取
- 改进日志记录：设置
log.mode: 'verbose'以检查行为 - 更严格的验证，防止词典问题导致应用崩溃
- 使用
build.importMode = 'live'和pnpm intlayer live实现与 CMS 的实时更新 - 修复：Vue.js 集成、Lynx 适配器、Windows 上的可视化编辑器
新功能：测试缺失的翻译
快速审核项目，找出缺失的键/语言。
bash
复制代码
复制代码到剪贴板
输出：
bash
复制代码
复制代码到剪贴板
查看更多 CLI 选项请参阅文档：CLI 参考 → “测试缺失的翻译”。以及 测试 指南。
新功能：全局 autoFill 自动补全缺失翻译
现在您可以全局启用 autoFill，任何缺失翻译的字典都会自动补全。
intlayer.config.ts
复制代码
复制代码到剪贴板
您仍然可以使用内容文件中的 autoFill 字段对每个字典进行微调。完整参考请见 doc/autoFill 和 doc/dictionary/content_file。
填充命令：更安全的默认设置
填充命令现在默认只填充缺失的翻译，跳过已有内容。
bash
复制代码
复制代码到剪贴板
bash
复制代码
复制代码到剪贴板
CI 示例可在 CI/CD 中查看。
更新的 VS Code 扩展
该扩展现在在活动栏中包含了一个专用的 Intlayer 选项卡，并带来了多个工作流改进：
- Intlayer 活动栏包含两个视图：
- 搜索网页视图 (
intlayer.searchBar)，用于实时字典/内容搜索 - 字典树 (
intlayer.dictionaries)，列出环境、字典和贡献文件
- 搜索网页视图 (
- 字典视图上的工具栏：构建、拉取、推送、填充、刷新、测试、创建字典文件
- 上下文菜单：字典上的拉取/推送；文件上的填充
- 自动显示：在适用时，当前编辑器文件会在词典树中高亮显示
- 命令面板新增命令：填充词典和测试词典
详情请参见官方 VS Code 扩展文档。
性能提升：快 10 倍
- 本地和远程词典并行解析
- 远程词典缓存，避免应用启动时重复获取
bash
复制代码
复制代码到剪贴板
输出：
bash
复制代码
复制代码到剪贴板
日志改进
日志系统已得到改进，能够提供有关构建和运行时转换过程中发生情况的更详细信息。
启用详细日志以更好地了解构建和运行时转换过程中发生的情况。
intlayer.config.ts
复制代码
复制代码到剪贴板
有关所有日志选项，请参见配置。
更强的验证
字典处理现在执行更强健的验证。当字典处理失败时，Intlayer 会避免破坏您的应用程序，并显示可操作的错误信息。
使用 CMS 的实时更新（生产安全）
在生产环境中提供实时内容更新（例如，编辑更新），无需重新构建您的应用程序。
- 启用实时导入模式：
intlayer.config.ts
复制代码
复制代码到剪贴板
- 运行您的应用程序并实时处理并行执行：
bash
复制代码
复制代码到剪贴板
注意：
- 只有标记为使用实时模式的字典会被实时获取。其他字典则经过性能优化。
- 如果无法访问实时 API，则回退到动态导入。
迁移说明
- 移除：
dictionaryOutput（之前为i18next或next-intl）。此功能将在未来版本中以可插拔适配器形式回归。请从配置中删除该字段。 - 相关移除：
i18nextResourcesDir（详见doc/configuration更新日志）。 - 推荐使用新的全局选项
content.autoFill来大规模生成缺失的翻译。 - 使用
npx intlayer content test来检测 PR 中缺失的翻译。 - 若需详细诊断，请设置
log.mode = 'verbose'。
修复
- Vue.js 集成稳定性提升
- Lynx 适配器改进
- Windows 上的可视化编辑器