从课程正文翻译到完整学习体验
A Tour of Go 多语言翻译项目最初的重点是课程页面本身。
项目采用完整页面作为最小翻译单元:
完整 present.Section
↓
翻译
↓
结构验证
↓
页面发布这种方式能够保证左侧课程内容完整本地化。
但是,在实际使用过程中发现:
右侧 Playground 示例代码中的注释仍然保持英文。
例如:
// Create a huge number by shifting a 1 bit left 100 places.
// In other words, the binary number that is 1 followed by 100 zeroes.
// Shift it right again 99 places, so we end up with 1<<1, or 2.对于初学者来说,阅读教程时需要在中文正文和英文代码注释之间切换,学习体验并不完整。
因此,项目进一步扩展翻译范围,将 Example 纳入统一翻译流程。

Example 作为独立 TranslationUnit
为了避免简单文本替换带来的风险,项目没有将 Example 当作普通字符串处理。
设计上:
- Page 是一种 TranslationUnit;
- Example 是另一种 TranslationUnit。
其中:
- Page 翻译单元对应完整
.article; - Example 翻译单元对应完整
.go文件。
项目文档明确:
Example 翻译单元是完整
.go文件。
同时,Example source 的哈希覆盖整个文件:
source_sha256 覆盖文件全部字节,而不是只覆盖注释。这样可以保证:
- 代码内容变化能够被检测;
- 翻译过程不会只关注注释片段;
- Example 可以和 Page 使用相同 workflow 管理。

.go 文件作为翻译单元。使用 Go scanner 保护代码结构
代码文件与普通文本最大的区别在于:
代码中只有部分内容可以翻译。
例如:
可以翻译:
// Calculate the result不能修改:
package main
import "fmt"
func main()因此,Example 翻译流程采用专门处理方式:
Go scanner
↓
识别真实注释
↓
保护代码、字符串、布局等内容
↓
只开放自然语言注释 payload
↓
恢复完整 Go 文件具体实现中:
- 使用 Go scanner 识别真实注释;
- 将代码、字符串、布局、注释分隔符以及机器语义注释替换为保护 token;
- 只允许普通自然语言注释参与翻译;
- 使用统一 glossary 保持术语规则。
这样可以避免:
- 修改 Go 标识符;
- 破坏字符串内容;
- 改变代码结构;
- 导致 Example 无法运行。

翻译后的 Playground Example
完成 Example 翻译后,代码结构保持不变,只更新自然语言注释。
例如:
// 将 1 左移 100 位,得到一个非常大的数。
// 换句话说,这个二进制数由 1 后跟 100 个 0 组成。
// 再将它向右移 99 位,最终得到 1<<1,也就是 2。同时:
package main
import "fmt"
func main()等代码内容保持原样。
最终效果:
- 左侧课程正文为中文;
- 右侧 Playground 注释为中文;
- 示例代码仍然可以正常运行。
这意味着 A Tour of Go 的学习体验从“课程翻译”进一步扩展到“完整教程本地化”。

Example 翻译纳入统一发布流程
Example 并不是单独处理的临时功能。
它与 Page 共用:
- TranslationUnit 管理;
- batch workflow;
- validation;
- Translation Quality Review;
- promotion;
- release projection。
整体流程:
Page / Example TranslationUnit
↓
export
↓
model translation
↓
process
↓
automatic validation
↓
Translation Quality Review
↓
promotion
↓
ready
↓
publish这样未来扩展更多语言版本时,不需要为不同内容类型重新设计流程。
总结
Playground Example 本地化是 A Tour of Go 多语言翻译项目的重要一步。
它解决的不只是几行代码注释翻译,而是:
- 将 Example 纳入统一翻译体系;
- 建立代码文件专用保护机制;
- 保证翻译过程不会破坏 Go source;
- 让课程正文和代码示例保持一致的语言体验。
最终,项目实现了:
课程正文本地化
+
代码示例本地化
=
完整学习体验本地化这也为后续支持更多语言版本提供了统一基础。
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 官方无隶属、授权或背书关系。
