背景:翻译项目需要面对 upstream 变化
A Tour of Go 的课程内容来源于官方仓库:
golang/website早期流程比较简单:
官方源码
↓
翻译
↓
验证
↓
发布这种方式适合首次翻译,但不适合长期维护。
当 upstream 内容发生变化时,需要回答几个问题:
- 哪些课程页面发生变化?
- 已有译文是否仍然有效?
- 是否需要重新翻译?
- 哪些页面可以继续复用?
因此,本次为 go-tour-i18n 增加 upstream revision 同步机制。
记录官方源码基线
项目现在会记录对应的 upstream commit:
upstream_commit
upstream_commit_timerelease manifest 中包含:
{
"upstream_commit": "645042eb697eaf69e33a9af00c6b5b3fffdead5a",
"upstream_commit_time": "2026-08-20T05:56:11Z"
}这样每一个正式发布版本都能够明确对应:
- 哪一个官方源码版本;
- 哪一次翻译结果;
- 哪一个生产 release。

自动检测 upstream source 变化
当官方源码更新后,项目首先进行 source preview。
本次检测发现:
welcome.article删除旧的简体中文社区翻译链接;basics.article将var修改为 inline code 标记;- 93 个 referenced Example source 没有内容变化。
检测结果:
Page unchanged=103
content_changed=0
Example unchanged=93
content_changed=0
conditional unchanged=2这意味着:
大部分课程内容无需重新翻译,只需要处理真正发生变化的部分。

stale 状态:避免覆盖历史翻译
以前翻译状态只有:
ready但是 upstream 改变后,原来的翻译不能简单认为仍然有效。
因此新增:
stale状态。
本次:
welcome/2basics/9
由于 source revision 变化,从原来的:
ready进入:
stale然后重新进入翻译流程。
这样可以避免:
- 误认为旧译文仍然对应新源码;
- 人工遗漏 upstream 修改。

重新生成翻译批次
针对变化页面,生成新的翻译任务:
chatgpt-zh-CN-013包含:
welcome/2
basics/9完整流程:
export
↓
ChatGPT raw response
↓
process
↓
restore
↓
validation
↓
Translation Quality Review
↓
promotion本次结果:
process:
restore_passed=2
restore_failed=0
validation:
validation_passed=2
validation_failed=0
review:
2/2 approved并且质量评级:
A
promotion 前置检查
重新翻译完成后,并不会直接发布。
项目增加 promotion preflight。
本次检查:
unit_count=122
page_count=103
example_count=19
changed_count=2
unchanged_count=120
review_approved_count=122
can_apply=true确认:
- 所有翻译单元完整;
- 页面数量正确;
- Example 状态正常;
- Review 已通过。
之后才允许进入正式应用。

生成新的 production release
最终生成 release bundle:
{
"locale": "zh-CN",
"upstream_commit": "645042eb697eaf69e33a9af00c6b5b3fffdead5a",
"translation_units": 122,
"pages": 103,
"eligible_examples": 19,
"articles": 7
}当前 release 包含:
- 122 个 translation units;
- 103 个课程页面;
- 19 个可执行 Example;
- 7 个 article 文件。

总结
本次 upstream 同步机制的实现,使 go-tour-i18n 完成了一次重要升级:
从:
一次性翻译项目变为:
持续维护的多语言课程系统新的维护流程:
golang/website upstream
↓
commit baseline
↓
source diff
↓
stale detection
↓
translation regeneration
↓
validation
↓
Translation Quality Review
↓
promotion
↓
production release未来扩展更多语言版本时,可以复用同一套同步和验证流程,而不需要重新设计整个翻译体系。
Go 学习与文档多语言本地化项目
本系列完整记录 Go 学习与文档多语言本地化项目从 A Tour of Go 起步,逐步扩展到站点首页、项目说明页、学习内容、文档以及未来内容包的实际开发过程,包括架构设计、统一术语治理、整页翻译、结构保护、自动校验、独立质量审核、生产发布与长期维护。
项目源码:
✅ GitHub:shuijingwan/go-tour-i18n
语言版本:
当前跨项目目标语言池共包含 66 个语言版本。Go 项目本身目前提供 65 个社区 Production 语言版本,下面每一门 Go 语言版本都直接链接到其当前公开站点。语言列表沿用项目首页现有的展示顺序。
英语(美国)仅作为跨项目目标语言纳入列表,并不是单独的 Go Production 语言版本。当前 Go 的英文源内容仍为官方 generic English,因此英语(美国)链接到 Go 官方站点,而不是不存在的本地社区部署。
- 阿姆哈拉语
- 阿拉伯语
- 孟加拉语
- 葡萄牙语(巴西)
- 保加利亚语
- 加泰罗尼亚语
- 克罗地亚语
- 捷克语
- 丹麦语
- 荷兰语
- 英语(美国)(Go 官方英文站点)
- 英语(澳大利亚)
- 英语(加拿大)
- 英语(印度)
- 英语(新加坡)
- 英语(南非)
- 英语(英国)
- 爱沙尼亚语
- 菲律宾语
- 芬兰语
- 法语(法国)
- 法语(加拿大)
- 德语(德国)
- 德语(奥地利)
- 德语(瑞士)
- 希腊语
- 古吉拉特语
- 希伯来语
- 印地语
- 匈牙利语
- 印度尼西亚语
- 意大利语
- 日语
- 卡纳达语
- 哈萨克语
- 韩语
- 西班牙语(拉丁美洲)
- 拉脱维亚语
- 立陶宛语
- 马来语
- 马拉雅拉姆语
- 马拉地语
- 书面挪威语(Bokmål)
- 波斯语
- 波兰语
- 葡萄牙语(葡萄牙)
- 旁遮普语(果鲁穆奇文,印度)
- 罗马尼亚语
- 俄语
- 塞尔维亚语(西里尔文)
- 简体中文(中国大陆)
- 简体中文(新加坡)
- 斯洛伐克语
- 斯洛文尼亚语
- 西班牙语(西班牙)
- 斯瓦希里语(坦桑尼亚)
- 瑞典语
- 泰米尔语
- 泰卢固语
- 泰语
- 繁体中文(台湾)
- 繁体中文(香港)
- 土耳其语
- 乌克兰语
- 乌尔都语
- 越南语
项目正在持续扩展新的 Go 学习与文档内容,并长期维护各语言版本的术语一致性、翻译质量、独立审核、生产发布与后续更新。
本项目属于非官方社区多语言本地化项目,与 Go 官方无隶属、授权或背书关系。

