翻译本地化 CSV 文件

游戏本地化 CSV 文件包含一个键列和每种语言一列。KAERIS 读取键和源列，并为每种目标语言添加一列。

KAERIS 翻译了此页面，并通过回译检查了每一行。尚未经过母语人士审阅。英文原文

本地化 CSV 文件的构建方式

第一列是键，第二列是源文本；标题命名列（keys,en）。包含逗号或换行的单元格会被引用。完全空白的行将被忽略。

源文件translations.csv

keys,en
GREETING,"Welcome back, %s!"
ITEMS,"You have {count} items, %d of them new"
QUIT,Quit game

CSV 翻译注意事项

每种语言一列
输出包含键列、源列，然后是 de、ja 等。您的键和源列名称将保留。
公式
以 =、+、- 或 @ 开头的单元格将添加前导撇号，以便 Excel 将其显示为文本而不是运行公式。
Printf 和花括号变量
单元格中的 %s、%d 和 {count} 将与源进行比较。在下面的实际运行中，这三者都得到了保留。
引用
单元格内的逗号和引号会被 CSV 写入器引用，因此一个翻译的单元格不会溢出到下一列。

实际运行：翻译为德语并进行检查

实际运行，27 October 2026，未手动编辑任何内容：kaeris translate translations.csv --langs de，使用 kaeris 0.2.35，耗时 2.5 秒，模型 google/gemini-2.5-flash-lite，免费套餐默认。下方是它生成的德语文件以及 kaeris check 的相关说明。

德语结果translations/translations.csv

keys,en,de
GREETING,"Welcome back, %s!","Willkommen zurück, %s!"
ITEMS,"You have {count} items, %d of them new","Sie haben {count} Artikel, davon %d neu"
QUIT,Quit game,Spiel beenden

kaeris 检查exit code 0

$ kaeris check --source translations.csv --langs de
✓ de: complete & placeholder-safe
✓ all locales complete & placeholder-safe

KAERIS 的处理方式

相同的列，更多的语言
键列和源列得以保留；每种目标语言都是新的一列。在终端中，结果将写入源文件旁边的 translations/localization.csv，然后 kaeris check 会从那里读取。
电子表格安全单元格
类似公式的单元格将作为文本写入。有关游戏引擎方面的内容，请参阅游戏页面。
此格式免费检查
在 /check 上的免费检查可以读取此格式，无需密钥或账户即可运行。终端命令 kaeris check 也可以读取它：自 kaeris 0.2.35 起，它支持所有 13 种格式，规则相同，且不会将任何内容发送到任何地方。

翻译您的文件免费检查您的文件

分三步运行

安装 CLI
运行 pip install kaeris。
翻译工作表
运行 kaeris translate localization.csv --langs de,ja,fr。
检查结果
运行 kaeris check --source localization.csv --langs de,ja,fr，或在免费检查页面上传文件：两者都会读取每种语言的列。

pip install kaeris
kaeris translate localization.csv --langs de,ja,fr --verify

问题

它对 Godot 和 Unity 有效吗？

该格式是键列、源列、语言列，正如这些引擎所期望的那样。请参阅游戏页面。

以 = 开头的单元格会作为公式运行吗？

不会。此类单元格的写入方式是让电子表格将其显示为文本。

免费吗？

是的，无需账户：每个文件 10,000 个字符，每次运行最多 8 种语言。免费的 API 密钥可将文件限制提高到 50,000 个字符。一次性付费 79 美元，使用您自己的 OpenRouter 密钥；月度套餐起价为 19 美元。价格

我可以在终端或 CI 中运行它吗？

是的。pip install kaeris，然后 kaeris translate localization.csv --langs de,ja。GitHub Action 在拉取请求中运行相同的翻译。 CLI 文档 · GitHub Action

继续

CLI 参考 · 检查参考 · 在浏览器中翻译 · 免费检查 · 格式转换 · 伪本地化

其他格式：JSON · YAML · .po · ARB · XLIFF · .strings · .xcstrings · .properties · .resx · Markdown · Fluent · Android XML