用每种语言发布你的 SaaS
你的 SaaS 产品需要用用户的语言说话——字面意思。UI 字符串、引导流程、邮件模板、帮助文档、错误消息。每一段文本都需要翻译,而且随着产品的演进,所有内容都需要保持同步。
better-i18n 为 SaaS 团队提供以开发者为中心的本地化工作流:代码库的 CLI 工具、工作流的 GitHub 集成、面向用户的 CDN 分发,以及前端的框架 SDK。
CLI:扫描你的代码库,同步你的翻译
@better-i18n/cli 是开发者工作流的基础:
scan— 使用 AST 分析检测代码库中的硬编码字符串。在本地或 CI 中运行,在部署前捕获未翻译的字符串。sync— 将你的本地翻译键与云端进行比较并调和差异。保持本地文件和平台同步。
两个命令都支持 CI 集成标志:
--ci用于非交互式 CI/CD 环境--staged仅检查暂存文件(非常适合 pre-commit 钩子)--format json用于机器可读输出
这意味着你可以将 better-i18n scan --ci 添加到 CI 流水线中,使引入硬编码字符串的构建失败。
GitHub 集成
当翻译准备就绪时,better-i18n 会创建包含翻译 JSON 文件的 Pull Request。你的团队像审查其他代码更改一样审查和合并翻译:
- PR 包含更新的 JSON 翻译文件
- 在发布事件时触发 Webhook 用于下游自动化
- 翻译与你的代码一起保留在版本控制中
这使翻译保持在你现有的审查工作流中——无需单独的工具来检查或批准。
CDN:无需部署的快速分发
已发布的翻译通过 Cloudflare 的边缘网络在 cdn.better-i18n.com/{org}/{project}/{locale}/{namespace}.json 上提供。这为你提供:
- 从最近的边缘节点进行全球低延迟分发
- 无需重新部署 — 发布翻译修正后立即生效
- 命名空间级别的粒度 — 仅加载当前视图需要的翻译
对于 SaaS 产品,这意味着你可以修正错误的翻译或添加新语言,而无需经历发布周期。
框架 SDK
第一方 SDK 处理与前端的集成:
@better-i18n/next— 支持服务器和客户端组件的 Next.js@better-i18n/use-intl— Vite 和 TanStack Router 应用@better-i18n/expo— Expo 和 React Native,带有移动应用的离线缓存
SDK 从 CDN 获取翻译,因此你的应用始终提供最新发布的内容。
MCP:在编辑器中进行 AI 辅助翻译
MCP 集成提供 2 个服务器和 28 个工具,与 AI 编程助手配合使用——Claude、Cursor、Windsurf 和 Zed。提供远程和本地服务器选项。
使用 MCP,你的开发人员可以:
- 无需离开编辑器即可创建和更新翻译键
- 为新键触发 AI 翻译
- 内联查看翻译覆盖率
这减少了上下文切换,使翻译管理保持在开发者的自然工作流中。
带术语表的 AI 翻译
better-i18n 的 AI 翻译生成尊重你产品术语的翻译:
- 在术语表中定义产品名称、功能名称和技术术语
- 从仪表板中选择适合你质量需求的 AI 模型
- 术语表术语在所有 AI 生成的翻译中执行
对于具有特定术语(方案名称、功能名称、技术概念)的 SaaS 产品,这确保了所有语言的一致性。
用命名空间组织
按产品结构组织你的翻译:
ui/common用于共享 UI 组件ui/dashboard用于仪表板特定的字符串emails/transactional用于邮件模板docs/help用于帮助中心内容errors用于错误消息
每个命名空间独立加载,因此你的仪表板页面不需要下载帮助中心的翻译。
仪表板和 RBAC
仪表板提供:
- 跨所有语言和命名空间的覆盖率追踪
- 带搜索和批量操作的键管理
- 每次更改的审计日志
- 通过 GitHub OAuth 实现项目级角色的 RBAC
给产品团队检查覆盖率的读取权限,给开发者管理键的编辑权限,将管理员权限限制给团队负责人。
我们不提供的
对局限性保持诚实:
- 仅 JSON — 我们不支持 YAML、PO、ARB、XLIFF 或其他翻译格式。如果你的技术栈需要非 JSON 格式,你需要进行转换。
- 仅 GitHub — 目前没有 GitLab、Bitbucket 或其他 Git 提供商集成。
- 无翻译记忆 — 一致性来自术语表执行和 AI 翻译,而非 TM 数据库。
- 无上下文编辑 — 没有针对你应用的可视预览或实时编辑覆盖层。
- 无上下文截图 — 键按名称和命名空间管理,而非按可视上下文。
- 无 OTA 更新系统 — CDN 按需提供翻译,但没有基于推送的更新机制或客户端缓存失效。
better-i18n 是为在代码中工作的团队构建的。CLI、GitHub 集成和框架 SDK 是核心工作流——仪表板是补充,而非替代开发者体验。
开始使用
如果你的 SaaS 团队想要一个适合现有开发流程的本地化工作流——CI 中的 CLI、用于审查的 PR、用于分发的 CDN——better-i18n 正是为此而构建的。
创建你的账户,几分钟内运行你的第一次 scan。