i18n Inserter

批量插入多语言翻译到 JSON 文件的 VSCode 插件。

功能

• 可视化界面配置目录位置和层级路径
• 支持多语言 JSON 内容输入
• 支持覆盖或跳过已有键的策略
• 实时显示处理结果
• 预览功能：执行前查看将要生成的文件内容
• 自动排序：保持 JSON 键按字母顺序排列
• 详细统计：显示更新和跳过的条目数量
• 可配置的语言文件映射：支持添加、删除和修改语言映射
• 侧边栏快速访问：点击左侧图标即可打开

使用方法

方式一：通过侧边栏图标

1. 点击 VSCode 左侧活动栏的地球图标（🌐）
2. 在侧边栏中直接使用插件功能

方式二：通过命令面板

1. 按 Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (Mac) 打开命令面板
2. 输入 i18n: 打开多语言插入工具

操作步骤

1. 在打开的面板中配置：
   • 目录位置: 多语言文件所在目录（相对于工作区根目录）
   • 层级路径: 目标层级路径，使用点号分隔（例如：common.buttons）
   • 插入策略: 选择覆盖或跳过已有键
   • 多语言 JSON 内容: 粘贴你的翻译内容
2. 点击"预览"按钮查看将要生成的文件内容
3. 确认无误后，点击"执行插入"按钮
4. 在页面底部可以配置语言文件映射关系，支持添加、删除和修改

JSON 格式示例

{
  "en": { "hello": "Hello", "world": "World" },
  "zh-CN": { "hello": "你好", "world": "世界" },
  "vi": { "hello": "Xin chào", "world": "Thế giới" }
}

支持的语言

默认支持以下语言（可通过配置自定义）：

• en (英语)
• es (西班牙语)
• ms (马来语)
• pt (葡萄牙语)
• vi (越南语)
• zh-CN (简体中文)
• zh-TW (繁体中文)
• id (印尼语)
• bn (孟加拉语)

配置

可以在 VSCode 设置中预设默认值：

• i18nInserter.directory: 默认目录位置
• i18nInserter.targetPath: 默认层级路径
• i18nInserter.strategy: 默认插入策略
• i18nInserter.langFileMap: 语言代码与文件名的映射关系

自定义语言文件映射

在 VSCode 设置中配置 i18nInserter.langFileMap 来自定义语言代码与文件名的对应关系：

{
  "i18nInserter.langFileMap": {
    "en": "en.json",
    "zh-CN": "zh-CN.json",
    "vi": "vi.json",
    "custom-lang": "custom.json"
  }
}

你可以添加、删除或修改任何语言映射。默认配置包含 9 种常用语言。

安装

1. 将此文件夹复制到 VSCode 扩展目录
2. 或者在此目录下运行 npm install 然后按 F5 调试

开发

cd i18n-inserter
npm install
# 按 F5 启动调试

更新日志

v0.0.2

• 新增预览功能
• 新增自动备份功能
• 新增 JSON 键自动排序
• 新增可配置的语言文件映射
• 改进错误处理和输入验证
• 优化 UI 界面和用户体验
• 显示详细的更新统计信息