让Bongo Cat走向世界：国际化翻译社区协作指南

2026-02-05 05:52:17作者：秋阔奎Evelyn

你是否曾因语言障碍无法让全球用户体验Bongo Cat的萌趣互动？作为一款拥有3种语言支持的桌面宠物软件，Bongo Cat的国际化翻译社区正等待你的加入。本文将带你掌握从翻译贡献到版本发布的全流程，让这只可爱猫咪跨越语言边界，陪伴更多用户的日常操作。

翻译框架解析

Bongo Cat采用Vue I18n（Internationalization，国际化）框架实现多语言支持，核心配置位于src/locales/index.ts。该文件通过createI18n函数初始化国际化环境，目前已集成英语（en-US）、中文（zh-CN）和越南语（vi-VN）三种语言包。系统默认语言为英语，当某些文本在目标语言中缺失时，会自动回退到英语版本。

export const i18n = createI18n({
  legacy: false,
  locale: LANGUAGE.EN_US,
  fallbackLocale: LANGUAGE.EN_US,
  messages: {
    [LANGUAGE.ZH_CN]: zhCN,
    [LANGUAGE.EN_US]: enUS,
    [LANGUAGE.VI_VN]: viVN,
  },
})

翻译文件结构

所有翻译文本采用JSON格式存储在src/locales目录下，每种语言对应独立的JSON文件：

文件采用多级嵌套结构，按功能模块组织键值对。以偏好设置页面的猫咪设置为例，中文版本的结构如下：

"pages": {
  "preference": {
    "cat": {
      "title": "猫咪设置",
      "labels": {
        "modelSettings": "模型设置",
        "mirrorMode": "镜像模式",
        "singleMode": "单键模式",
        // 更多设置项...
      }
    }
  }
}

翻译贡献流程

1. 翻译文件选择

根据你的语言专长，选择对应的JSON文件进行翻译。建议优先关注用户高频使用的界面元素，如：

偏好设置：涵盖猫咪行为、窗口显示、快捷键等核心配置
组件文本：包括按钮标签、提示信息和状态说明
菜单选项：系统托盘和上下文菜单的文本内容

2. 翻译规范要点

保持键名一致：所有语言文件使用相同的JSON键结构，仅修改值部分
专业术语统一：技术术语如"passThrough"（窗口穿透）需保持翻译一致性
长度控制：考虑UI显示空间，避免文本过长导致截断
文化适配：如越南语版本将"Always On Top"译为"Luôn trên cùng"（始终在顶部）

3. 示例对比

以"窗口穿透"功能的提示文本为例，三种语言的翻译对比：

语言	原文	翻译
中文	"启用后，窗口不影响对其他应用程序的操作。"	src/locales/zh-CN.json
英文	"When enabled, the window will not affect operations on other applications."	src/locales/en-US.json
越南语	"Bật để cửa sổ không ảnh hưởng đến thao tác trên ứng dụng khác."	src/locales/vi-VN.json