为什么需要
做海外市场,多语言是基本功。传统流程是:写代码提取翻译 key → 导出 JSON → 发给翻译 → 导回 → 测试。来回折腾,效率低,翻译质量还不好——因为翻译的人看不到上下文。Tolgee 解决的核心问题就是:让翻译直接在你的 App 里完成,所见即所得。
怎么用
- 部署 Tolgee(Docker 一行命令):
docker run -v tolgee_data:/data -p 8080:8080 tolgee/tolgee - 在项目里安装 SDK:
npm install @tolgee/react(也支持 Vue、Angular、Svelte、Next.js) - 配置 Tolgee 实例地址和 API Key
- 在代码里用
<T tKey="hello" />替代硬编码字符串 - 开发/生产环境按住 ALT 点击文字,直接在页面上编辑翻译
typescript
import { Tolgee, DevTools, ReactPlugin } from "@tolgee/react";
const tolgee = Tolgee()
.use(ReactPlugin())
.use(DevTools())
.init({
language: "en",
apiUrl: "https://app.tolgee.io",
apiKey: "your-api-key",
});
核心功能
- 上下文翻译:ALT+点击页面元素,直接在 App 里编辑翻译,翻译人员能看到文字在哪个按钮/标题
- 截图标注:一键截取当前页面,自动标注翻译 key
- 机器翻译:集成 DeepL、Google Translate、AWS Translate,自动建议
- 翻译记忆:基于已有翻译自动推荐相似翻译
- MCP Server:AI 编程助手可以直接在 IDE 里管理翻译
- 多平台 SDK:React、Vue、Angular、Svelte、Next.js、Flutter 都有官方 SDK
注意事项
- 开源免费(Apache 2.0 + Tolgee EL),可自托管
- Cloud 版免费层:1 个项目、1000 个 key、10 个语言
- 翻译记忆和机器翻译在免费层就可用
- 支持导出 JSON、PO、XLIFF 等格式
- 社区活跃,文档完善