Weblate 介绍与选型指南

目标：说清 Weblate 是什么、能解决什么问题、核心架构与功能边界，并给出与同类本地化平台的量化选型对比。本文为认知篇，所有数据均来自官方源实查（标注来源与查询日期），配套的部署实测见本专栏《Weblate Docker Compose 部署指南》。

一、环境信息

本篇为联网溯源的认知篇，不依赖本地环境实测，以下为取证环境说明：

• 查询日期：2026-10-21
• 版本取证来源：GitHub Releases（https://github.com/WeblateOrg/weblate/releases/latest）
• 社区数据来源：shields.io 动态徽章（license / stars / contributors，https://img.shields.io/github/...）
• 功能与架构来源：官方文档站（https://docs.weblate.org/）与官方仓库 README
• 本地化验证：官方 Docker 部署文档（https://docs.weblate.org/en/latest/admin/install/docker.html）

二、软件概述

Weblate 是一个开源的本地化（localization）/持续翻译管理平台，由 Michal Čihař 于 2012 年发起，采用 Python + Django 编写，前后端一体交付，用于管理软件、网站、文档等多语言资源的翻译流程。它最大的差异化定位是「与版本控制系统（Git 等）原生融合的持续本地化」——翻译结果不是导出文件再人工回传，而是直接以提交（commit）形式写回翻译仓库，配合推送/拉取钩子形成与代码开发并行的持续翻译流水线。

💡 技术拓展：「本地化平台」与「翻译记忆库（TM）」「机器翻译（MT）」是三个常被混用的概念。本地化平台是管理工作流的中枢（谁翻、翻什么、何时入库），TM 是历史译文复用数据库（相同/相近句子自动带出），MT 是机翻引擎（Google/DeepL/Weblate 内置 LibreTranslate 等）。Weblate 属第一类，同时内置 TM 与 MT 集成能力。

核心事实（均实查于 2026-10-21）：

关键解读：Weblate 的版本号按「年.月」滚动命名（如 2026.10.1 即 2026 年 10 月第 1 个修订），不存在传统意义的「大版本 3.x/4.x」升级断层；但生产环境仍应钉死具体修订号（Docker Hub 上对应 tag 形如 2026.10.1.1），避免跟随 latest 引入不可控行为变更。

三、核心架构

按官方文档与源码仓库描述（实查 2026-10-21），Weblate 单体应用由以下协作部分组成：

数据流主线：翻译仓库（Git/Mercurial/SVN）⇄ Weblate 后台拉取（webhook 或定时）⇄ 解析为翻译单元（gettext PO、JSON、XLIFF 等 150+ 文件格式）⇄ 翻译者在 Web 编辑器/REST API 修改 ⇄ 建议与检查（一致性检查、TM、MT）⇄ 达到提交条件后自动 commit 并 push 回仓库。

关键解读：这套「仓库即真相源（single source of truth）」的设计是 Weblate 与 SaaS 平台（翻译数据存在云端库）最本质的差异——源文件始终在你自己的代码仓库里，Weblate 只是协作层的增量写入者，随时可拆可重建。

四、功能特性

以下清单实查自官方功能页与部署文档（2026-10-21）：

• VCS 持续本地化：翻译提交直接写回 Git/Mercurial/Subversion 仓库，支持 GitHub/GitLab/Gitea/Bitbucket/Azure DevOps/AWS CodeCommit 的 PR/MR 流；
• 150+ 文件格式：gettext PO/MO、XLIFF、JSON、ARB、RESX、CSV、YAML、Android/iOS 字符串资源、TBX 术语表等；
• 翻译辅助：翻译记忆（项目内/共享）、机器翻译集成（DeepL、Google、OpenAI、LibreTranslate 等十余种）、自动建议、一致性检查（90+ 质量检查规则）；
• 协作与审核：建议与投票、双语审校（review 工作流）、术语表（每项目自动建 glossary 组件）、截图文案对照、注释沟通、通知订阅；
• 权限模型：项目级访问控制（公开/受保护/私有）、团队与细粒度角色、双因素认证（TOTP/WebAuthn）；
• 扩展机制：附加组件（Add-ons，自动提交、自动翻译、一致性替换等 30+ 种）、Webhook、REST API（全功能覆盖，官方 wlc 命令行客户端）；
• 多语言能力：800+ 内置语言定义（含复数规则、书写方向、别名归一化，如 zh_CN 自动归一为 zh_Hans）；
• 可观测：内置 metrics 端点、配置健康检查、Celery 队列监控命令。

五、快速开始（最小可用示例）

本节转述官方推荐的最小部署路径（来源：官方文档 docs.weblate.org/en/latest/admin/install/docker.html，查询日期 2026-10-21；逐步实测与真实回显见本专栏《Weblate Docker Compose 部署指南》）。官方 Docker Compose 方案由三个服务组成：

1. weblate：主服务（官方镜像 weblate/weblate，内置 nginx 与 Celery worker）；
2. database：PostgreSQL（官方模板当前钉 postgres:18-alpine）；
3. cache：Redis/Valkey 缓存与队列（官方模板当前钉 valkey/valkey:9.1.2）。

最小启动序列（官方模板精简形态）：

# 官方模板仓库 WeblateOrg/docker-compose 提供编排文件与 environment 环境变量样例
wget https://raw.githubusercontent.com/WeblateOrg/docker-compose/main/docker-compose.yml
wget https://raw.githubusercontent.com/WeblateOrg/docker-compose/main/environment
docker compose up -d

启动完成后访问 http://<服务器地址>/（默认 80 端口）即可进入翻译工作台，管理员账号由 environment 中的 WEBLATE_ADMIN_NAME/WEBLATE_ADMIN_PASSWORD 在首次启动时自动创建。

💡 说明：官方镜像监听 8080 端口（以非特权用户运行），官方编排将其映射到宿主机 80；若宿主机 80 已被占用，改映射端口即可（本专栏部署篇实测映射到 8143）。

六、适用场景与限制

适合（按官方定位与社区实践归纳）：

• 软件/库/App 的界面文案持续本地化，翻译仓库与代码仓库同流水线演进；
• 开源项目社区翻译：公开项目 + 志愿者协作 + 提议审校工作流；
• 文档站、固件、嵌入式资源文件的多语言管理（PO/JSON/RESX 等）；
• 需要「译文资产自持」的团队：数据在自己 Git 仓库，平台可随时重建。

限制与注意（实查官方文档与仓库 Issues，2026-10-21）：

• 生产数据库仅支持 PostgreSQL（官方明确不保证 MySQL/SQLite 支持质量）；
• 资源占用不轻：主服务进程常驻内存约 2 GB 量级（本专栏部署篇实测），小规格服务器需预留资源；
• GPL-3.0 许可对 SaaS 化二次分发有传染性约束，商业闭源集成需评估或购买商业许可；
• 机器翻译引擎多为第三方付费服务，开箱即用的免费 MT 有限（内置 LibreTranslate/Weblate 自研质量有限）。

七、同类选型对比

关键解读：若核心诉求是「翻译结果直接进 Git 仓库、与 CI 并轨」，Weblate 是自托管路线里唯一兼具活跃度、格式覆盖与 API 完整度的成熟选择；若只是 App/Web 键值文案的快速协作、不强求 VCS 直连，Tolgee 更轻；若完全不想运维，Crowdin/Transifex 托管更省心。决策锚点按序检查三点：数据主权（是否要求译文入自家仓库）→ 运维预算（是否有人管 2 GB 内存级服务）→ 许可合规（GPL-3.0 传染边界）。

八、参考链接

• 官网：https://weblate.org/

• 源码仓库：https://github.com/WeblateOrg/weblate

• 官方 Docker Compose 编排仓库：https://github.com/WeblateOrg/docker-compose

• Docker 部署文档：https://docs.weblate.org/en/latest/admin/install/docker.html

• REST API 文档：https://docs.weblate.org/en/latest/api.html

• wlc 命令行客户端文档：https://docs.weblate.org/en/latest/wlc.html

• 本专栏部署实测：《Weblate Docker Compose 部署指南》

• 本专栏系列：《Weblate 2026.10.1 常用 CLI 命令与工具详解》、《Weblate 2026.10.1 配置参数详解》。