跳到主要内容

多语言支持

MintCat 支持多语言界面，当前主要维护中文与英文。语言设置会保存在本地配置中，导入旧配置后也会尝试恢复对应语言偏好。

切换语言​

  1. 打开 MintCat。
  2. 进入 设置 页。
  3. 找到 MintCat Settings。
  4. 在语言选项中选择目标语言。
  5. 保存后界面会刷新。

如果部分文本没有立即变化，可重启应用。

当前语言文件​

项目内语言资源位于：

  • src/locales/zh-CN.json
  • src/locales/en.json
  • src/locales/i18n.ts

用户不需要手动修改这些文件。它们主要面向开发和翻译贡献者。

翻译范围​

语言文件通常覆盖：

  • 菜单和按钮。
  • 弹窗标题和提示。
  • 设置项名称。
  • 错误信息。
  • 状态栏文案。
  • 新手引导文案。

平台返回的 Mod 名称、作者说明、第三方网页内容不一定会被翻译。

贡献翻译​

如果你希望帮助改进翻译：

  1. 找到对应语言 JSON 文件。
  2. 保持 key 不变，只修改 value。
  3. 尽量保留占位符、变量和标点结构。
  4. 提交 Pull Request 或反馈给维护者。

示例：

{
  "Save": "保存",
  "Add Mod": "添加 Mod"
}

新增语言​

新增语言通常需要：

  1. 新增一个语言 JSON 文件。
  2. 在 i18n 初始化中注册该语言。
  3. 在设置页语言选项中加入新语言。
  4. 检查所有页面显示是否正常。

建议先从中文或英文文件复制一份，再逐项翻译。

常见问题​

切换语言后部分文本仍是英文​

可能原因：

  • 该文本还没有翻译。
  • 文案来自第三方平台。
  • 页面缓存了旧状态，需要重启应用。

导入旧配置后语言变了​

配置导入会尝试恢复旧版本中的语言设置。如果不符合预期，请到设置页重新切换。

可以混合显示两种语言吗​

目前不建议。界面语言以设置项为准，第三方内容可能保持原始语言。