没有不值得去解决的问题,也没有不值得去学习的技术!

A Tour of Go 多语言翻译项目:zh-CN 103 个课程页面全部 ready,课程正文翻译阶段完成

图 4:上游源码确认共有 103 个课程页面,zh-CN 最终达到 ready=103、pending=0、blocked=0

作者:

在

,

A Tour of Go 多语言翻译项目

图3:访问过去的 Go Tour 简体中文站 tour.go-zh.org 时,当前已经无法正常建立连接。

(1) 从「A Tour of Go 中文版」这个搜索词开始:我决定做一个持续维护的 Go Tour 中文版

本地运行的 A Tour of Go「Methods continued」课程页面,左侧为课程说明,右侧为 Go 代码编辑器及运行结果。

(2) A Tour of Go 中文版项目设计冻结:从 101 页到 103 页,从 Gin 转向 Cobra CLI

A Tour of Go 中文版开发实战:英文基线、在线运行与 101 页上游同步体系

(3) A Tour of Go 中文版开发实战:英文基线、在线运行与 101 页上游同步体系

go-tour-i18n 项目完成首个简体中文课程页面 welcome/1 的整页翻译、结构校验和本地预览。

(4) A Tour of Go 多语言翻译项目实录:完成首个 zh-CN 页面翻译闭环

图 1:DeepSeek 官方更新日志显示,本次只更新 DeepSeek-V4-Flash,DeepSeek-V4-Pro API 与 APP、Web 模型均未更新

(5) A Tour of Go 中文翻译项目进展:完成前 8 页、修复 present 语法,并暂缓 DeepSeek 对比

图 1:generics/1 简体中文页面本地预览

(6) 一个页面重试五次:使用 GLM-5.2 翻译 A Tour of Go 时遇到的 Token 与 Present 结构问题

图 1:methods/16 简体中文页面浏览器预览

(7) A Tour of Go 中文翻译实录:如何只翻译教学代码注释,而不破坏 Go 代码

图 2:A Tour of Go methods/20「练习:错误」中文候选页面最终渲染效果

(8) A Tour of Go 多语言翻译:当正确的中文语序被受保护标记顺序校验误判

图 3:methods/24 中文页面,静态代码、Bounds 行内代码和链接内的 image.Rectangle 均正确渲染

(9) A Tour of Go 中文翻译完成 7 个代表页校准:最后 3 页又发现了哪些真实问题

图 2:首批 10 个普通页面经过试跑与流程校准后全部进入 ready

(10) A Tour of Go 多语言翻译项目:首批 10 个普通页面试跑,从 2 个 blocked 到全部 ready

图 2:flowcontrol/6 最终中文页面,return 与 v 为适应自然中文语序发生整体换位

(11) A Tour of Go 中文翻译第二批实跑:从 Inline Code 顺序误判到历史响应重新验证

图 1:flowcontrol/6 首次原始输入实验直接通过统一自动校验

(12) A Tour of Go 多语言翻译项目:从 swap 问题重新审视 Token 保护,原始输入与最小保护的一次真实实验

图 7:moretypes/1 最终中文页面预览。左侧课程正文、静态代码块、行内代码和教学注释均正常渲染,右侧官方 Go 示例继续保持原样。

(13) A Tour of Go 多语言翻译实战:第三批 10 页全部 Ready,继续校准 Protected Token 的结构角色

图 4:上游源码确认共有 103 个课程页面,zh-CN 最终达到 ready=103、pending=0、blocked=0

(14) A Tour of Go 多语言翻译项目:zh-CN 103 个课程页面全部 ready,课程正文翻译阶段完成

图 4:GitHub 与 ChatGPT 已成功连接

(15) ChatGPT 连接 GitHub 实测:让 AI 直接读取 go-tour-i18n 仓库参与译文审核

图 3:中文 Go 术语校准完成后,将确定的译法写入 zh-CN glossary

(16) 为什么 channel 最终选择“通道”:A Tour of Go 中文术语统一的一次实践

图 1:技术含义基本正确,但“返回一个返回……”已经明显影响阅读,因此仍被列入 C 类修订

(17) 103 页逐页审核后,只返修 16 页:A Tour of Go 中文正文发布前质量审计

图 2:中文课程页面以及已经完成本地化的编辑器控制区

(18) A Tour of Go 多语言翻译项目:公共 UI 本地化完成,从课程译文走向完整中文界面

图 2:完整 zh-CN 正式投影成功生成,103 个课程页面被重新组装为 7 个 .article

(19) 从 103/103 ready 到完整站点验收:A Tour of Go 中文版补齐正式投影与课程元数据本地化

图 3:从 production bundle 独立启动的 A Tour of Go 简体中文页面,课程正文、公共 UI 和官方 Go 示例均已进入最终发布形态。

(20) A Tour of Go 多语言翻译项目:103 页全部完成后,我终于生成了可独立部署的 zh-CN Production Bundle

图 1:A Tour of Go 简体中文版正式生产页面,远程运行已经成功输出“Hello, 世界”。

(21) A Tour of Go 多语言翻译项目:zh-CN 正式上线,从生产发布到 go.dev Playground 的完整部署记录

图 1:新生产域名 go-dev.shuijingwanwq.com 已正常访问,Go 示例远程运行成功

(22) A Tour of Go 多语言翻译项目:从 go-tour 到 go-dev,完成 EdgeOne、Nginx 与 HTTPS 生产域名迁移

图 1:A Tour of Go 多语言翻译项目正式生产首页

(23) A Tour of Go 多语言翻译项目正式上线:从项目首页、公共 Footer 到生产发布元数据的完整收尾

图 3:GA4 g/collect 请求返回 HTTP 204,并携带当前课程页面地址,确认 Google Analytics 已产生真实事件上报

(24) A Tour of Go 多语言翻译项目:接入 Google Analytics 与百度统计,从 systemd 注入到 EdgeOne 与真实上报验证

图 1:生产环境 robots.txt 与 sitemap.xml 已正确对外提供,Sitemap 共包含 104 个规范 URL。

(25) A Tour of Go 中文站上线后:补齐 robots.txt、Sitemap,并完成五大搜索引擎提交

图 4:发布生产并刷新 EdgeOne 缓存后,再次通过真实手机访问,顶栏项目名称已经完整保持在一行,最终移动端验收通过。

(26) A Tour of Go 多语言翻译项目:修复手机端首页顶栏标题换行,并完成真机验证

图 3:生产自动部署脚本第一次真实运行时,systemd 已经显示 active,但首次 localhost 探测仍然得到 HTTP 000;随后连续 3 次同时满足 active + HTTP 200 后,脚本才判定部署成功,并继续完成公网 HTTP 200 验收。这次真实运行验证了连续应用层健康检查的必要性。

(27) A Tour of Go 多语言翻译项目:从一次 203/EXEC 故障到生产自动部署脚本落地

图 1:阿里云生产环境访问 go.dev Playground 时出现 TLS 握手超时

(28) A Tour of Go 多语言翻译项目:为 Playground 搭建独立的 ZgoCloud 执行代理

图 3:清除 /tour/script.js 缓存后,Run 已直接请求 ZgoCloud /compile 并返回 HTTP 200

(29) A Tour of Go 多语言翻译项目:将生产 Run / Format 切换到 ZgoCloud 执行节点

【图 1:微信中运行 Go 示例时出现 Error communicating with remote server.】

(30) A Tour of Go 中文版手机端运行与格式化偶发失败排查:从间歇性报错到补强 Nginx 可观测性

【图 4:向 golang-dev 公开邮件列表发送 Playground 使用告知邮件并投递成功】

(31) A Tour of Go 多语言项目:为 Playground 代理增加唯一 User-Agent,并主动告知 Go 官方

【图 3:百度剩余 9 个核心 URL 提交成功,remain 归零】

(32) A Tour of Go 搜索引擎收录实测:从 Google 自然索引到百度主动提交与 Bing IndexNow

【图 1:当前正式中文 methods/24 页面,右侧示例代码运行成功】

(33) A Tour of Go 中文翻译完成后,我为什么重新评估 minimal-protect 翻译模式

【图 3:5 个页面 Request SHA256 完全一致,但 Response SHA256 全部不同】

(34) A Tour of Go 翻译实验:更多原始上下文为什么没有更好?从 157 个保护标记到 30 次重复盲评

图 3:3 个代表页 × 4 个评审模型,共 12 次匿名评审的完整排名与第一名票数。

(35) A Tour of Go 翻译质量再评估:minimal-protect 未达预期后,我开始比较 ChatGPT、Codex 与 GLM-5.2

图 2:GitHub 中的 chatgpt-zh-CN-008 重译批次。一个 Batch 同时保存 inputs、raw-responses、candidates、validation 和 retry 记录,GitHub 成为 ChatGPT 与本地翻译流水线之间的数据交接层。

(36) 没有 OpenAI API,我如何用 ChatGPT + GitHub 完成 A Tour of Go 103 页全量重译

图 1:103 个正式课程页面完成最终语义质量审核,结果为 A=103、B/C/D=0,同时不存在缺失、重复或额外页面。A/B/C/D 是本轮项目内部语义质量分级,并不是自动结构 validator 的结果。

(37) 103 页翻完还不能发布:A Tour of Go ChatGPT 译文的语义审核与 Canonical Promotion

图 3:7 个 article endpoint 的 production origin 与 EdgeOne 公网响应全部 exact match,同时新的 ChatGPT 译文标记存在,旧版译文标记已经消失。

(38) 103/103 与 7/7 Exact Match:A Tour of Go ChatGPT 新译文的最终线上验收

【图 2:upstream source preview】

(39) A Tour of Go 多语言翻译项目首次实现 upstream 同步机制:从一次性翻译到长期维护

图 2:A/B/C/D 质量评级规则,展示正式质量 rubric 与 Promotion gate。

(40) A Tour of Go 多语言翻译项目引入 Translation Quality Review:从自动验证到 AI 翻译质量控制

图 4:翻译后 Playground Example,展示中文注释与保持不变的 Go 代码结构。

(41) A Tour of Go 多语言翻译项目实现 Playground Example 本地化:从代码注释翻译到完整学习体验

图 5:公网页面验证广告脚本输出

(42) A Tour of Go 多语言翻译项目接入广告系统:从 AdSense 专用配置到通用 HTML 注入架构

图 3:百度统计单页应用设置

(43) go-dev 单页网站接入统计与 Google AdSense Auto Ads 验证记录

图 1:GitHub 仓库中的多语言翻译项目结构

(44) A Tour of Go 多语言翻译项目:选择日语作为第二语言并启动翻译验证

图 5:模型身份描述不一致

(45) A Tour of Go 多语言翻译项目中的 AI 协作异常排查:一次长期工程会话失效分析

【图 1:ChatGPT GitHub 写入流程调整说明截图】

(46) go-tour-i18n 翻译流程调整:从 ChatGPT GitHub 写入到本地 artifact 导入

图 4 展示了本次异常状态。

(47) go-tour-i18n 翻译自动化流程复盘:已验证的 ChatGPT 翻译能力在新任务中的稳定性问题

【图 6:全部评审结束以后才读取 secret key,完成最终揭盲】

(48) A Tour of Go 翻译质量再评估:Codex High 已接近 ChatGPT High,我决定调整默认翻译引擎

图 4:ja-JP 生产课程页实际运行 Go 示例

(49) A Tour of Go 日语版正式上线:第二门语言 ja-JP 完成生产发布

图 1:ja-JP 上线以后,先提交“新增语言标准化流程”

(50) A Tour of Go 多语言扩展复盘:为第三门语言建立标准化流程

图 1:课程正文结束以后,页面左侧仍然存在大块视觉空白,但 AdSense 并没有在这里插入展示广告。

(51) A Tour of Go 明明有大片空白,为什么 AdSense 就是不显示展示广告?

图 2:golang/website 当前的 _content/tour/。课程内容、静态资源和模板都在这个上游目录中持续维护。

(52) 为了 AdSense,要不要放弃 SPA?A Tour of Go 页面架构的一次取舍

图 4:最终的手动课程广告真实展示在课程内容区域内,而不是 footer 之后。

(53) 保留 SPA 以后,广告应该放在哪里?从 AdSense 预览到方案 B

图 1:Google Search Console 中,多个不同的 A Tour of Go 课程 URL 被判断为“重复网页,用户未选定规范网页”。

(54) SPA 的 SEO 老问题:为什么最后还是给 103 个 A Tour of Go 课程页生成了 Prerender HTML

图 2:方案 B 生产环境中,源码已经正常,但课程主体高度异常缩短,footer 提前进入第一屏。

(55) 从源码空白到 AdSense 高度污染:A Tour of Go 方案 B 的生产收尾

图 1:A Tour of Go 德语版 de-DE 已正式运行在生产环境

(56) A Tour of Go de-DE 上线复盘:第三门语言用了约 16 小时,下一门如何压到 8 小时?

图 1:fr-FR 首次 production 验收完成后,我没有立即开始 ko-KR,而是先连续完成新增语言与首次生产流程的优化

(57) 法语版上线后,我没有马上开始韩语:A Tour of Go 新增语言流程的一轮完善与简化

图 1:根据 ko-KR 期间 76 次 Git 提交估算实际工作时间

(58) 原本预计 6 小时,最后用了约 16~18 小时:A Tour of Go 韩语版上线复盘

图 2:英文 source 与当时发生 validation failure 的 ko-KR candidate 对比

(59) Validator 报错,到底该改译文还是改规则?一次 A Tour of Go 韩语翻译实战

图 2:法语 A Tour of Go 仓库目前已经归档,页面仍保留 553 Commits 和 61 Contributors 的历史

(60) 从法语 553 次提交到韩语两代离线:A Tour of Go 社区翻译为什么难以长期维护

【图 4:es-ES 首次 Production 收口后连续完成的流程优化 commit】

(61) 从 es-ES 首次上线复盘:我把 A Tour of Go 新增语言的 Production 流程又收敛了一轮

图 1:旧公网验收链路连续出现 curl 28 超时,最终导致 public-machine 阶段失败

(62) A Tour of Go Production 公网验收踩坑:从跨境 SOCKS 链路改为 zgocloud direct

图 1:两次 Production Machine Acceptance 都已经通过,但 Headless Chrome 分别在 / 和 /tour/ 判定页面没有完成渲染

(63) 页面明明能打开,为什么 Headless Chrome 仍然判定 Production 失败?

图 3:Bing 从 Google Search Console 中识别到新的 it-IT 站点,并同时发现已有的 1 个 sitemap

(64) GSC → Bing Webmaster Tools:多语言站点如何减少重复验证

图 3:英文站 3 小时内出现 565 个 Cloudflare 来源 URL

(65) IndexNow 实战:手工提交长期不显示,Cloudflare Crawler Hints 却很快出现在 Bing Webmaster Tools

【图 1:A Tour of Go 项目首页目前的语言版本列表】

(66) 从 nl-NL 到 tr-TR:A Tour of Go 连续上线三门语言后,我又优化了哪些流程

【图 4:Go local 页面中已经出现 French、German、Korean、Simplified Chinese】

(67) 从邮件无人回复到进入 Go 官方 Go local:我的 4 个 A Tour of Go 翻译站终于被收录

图8:最终只保留一把启用的新 API Key

(68) 腾讯云 EdgeOne API 自动化:从 CAM 子用户到最小权限 API Key 的完整配置

【图 7:Production Release Batch 最终汇总】

(69) 从同步 Go 官方上游到一个命令发布 10 个语言站:A Tour of Go Production 流程的再次收敛

【图 3:Cloudflare Smart Tiered Cache 已启用】

(70) Cloudflare 缓存 HIT 很快,MISS 却不稳定:回源阿里云杭州的一次真实优化

【图 3:简体中文站 Support 页面】

(71) 广告之外,社区项目如何长期活下去?我给 A Tour of Go 多语言项目加了 Support

图5:评论成功发布

(72) 从 Go Weekly 到 Reddit、DEV 和 Go Forum:第一次系统推广 A Tour of Go 多语言项目

经过前面的代表页面校准、保护规则调整、结构校验完善以及多轮普通页面批量翻译之后,A Tour of Go 多语言翻译项目终于到达了一个非常明确的里程碑:

  • ready=103
  • pending=0
  • blocked=0

也就是说,当前上游基线中的 103 个 A Tour of Go 课程页面已经全部完成简体中文翻译,并通过项目统一的自动校验流程。

需要特别强调的是,这还不代表中文版已经正式发布。

当前完成的是课程正文翻译阶段。下一阶段还要继续进行发布前全局验收,包括整体生成、浏览器渲染、公共 UI 文案、页面导航、发布产物以及生产部署边界等。

不过,仅就课程正文而言,这一阶段已经真正跑完了。

图 1:完成自动翻译与统一校验后的 A Tour of Go 简体中文课程页面
图 1:完成自动翻译与统一校验后的 A Tour of Go 简体中文课程页面

这次最终收尾过程中还连续遇到了两个很有代表性的案例:一个发生在行内代码结构恢复阶段,另一个发生在完整链接结构校验阶段。

它们最后都证明了一件事:

多语言翻译系统不能简单要求目标语言严格复制源语言的结构出现顺序。只要一个完整受保护结构本身没有遭到破坏,为适应目标语言自然语序而发生整体换位,本来就应该被允许。

这也是这轮全量翻译收尾阶段最有价值的两个发现。


一、从批量试跑进入真正的全量翻译

在代表页面以及前几批普通页面已经验证稳定之后,我继续按照每批 10 页的节奏推进剩余 pending 页面。

这一阶段没有再采用逐页人工翻译,而是继续沿用已经建立起来的统一流程:

完整课程页面 → GLM-5.2 整页翻译 → 保存 candidate → 自动结构和页面校验 → ready

如果失败,则继续:

有限整页重试 → 仍失败则进入 blocked

而 blocked 并不意味着一定要人工直接修改译文。

如果后来确认问题来自恢复逻辑或校验器本身,还可以直接利用已经保存下来的历史模型响应重新校验,而不需要再次调用模型。

这次后半程的状态推进非常直观:

阶段readypendingblocked
第 4 批完成55480
第 5 批完成65380
第 6 批完成75280
第 7 批完成85180
第 8 批完成9580
最后 8 页完成10300

越到后面,普通页面的一次通过率也越来越稳定。

例如第 8 批 10 页全部 attempt-001 一次通过;最后剩余的 8 个 concurrency 页面同样全部首轮通过。

不过在真正到达 103 / 0 / 0 之前,还有两个不能简单当作“模型翻译失败”的问题需要解决。


二、moretypes/18:模型没有少翻代码,恢复逻辑却把两个代码结构合并了

第 5 批处理中,moretypes/18 连续进行了 3 次翻译,最终都得到相同的错误:

inline code count mismatch: expected 9, actual 8

从结果表面看,很容易得出一个判断:

GLM-5.2 连续三次漏掉了一个行内代码结构。

但进一步检查三份原始响应后发现,事实恰恰相反。

源页面一共有 9 个行内代码:

  1. Pic
  2. dy
  3. dx
  4. (x+y)/2
  5. x*y
  6. x^y
  7. []uint8
  8. [][]uint8
  9. uint8(intValue)

三次模型响应都完整保留了 9 对行内代码保护标记,token_valid=true。

真正发生的问题来自中文自然语序调整。

原文中存在:

Plaintext
each `[]uint8` inside the `[][]uint8`

模型自然地翻译成了类似:

Plaintext
为 `[][]uint8` 中的每个 `[]uint8`

也就是说,两个完整行内代码结构发生了整体换位。

这本身完全正确。

与此同时,另外几个函数被模型输出成:

Plaintext
`(x+y)/2`、`x*y` 和 `x^y`

问题就出现在这里。

原来的 normalizeInlineTokenBoundaries 会按照源文本中的 pair 顺序逐个寻找保护标记。

当它搜索到后面的 []uint8 与 [][]uint8 时,因为这两个 pair 已经按中文语序交换位置,搜索失败,函数直接提前退出。

结果就是:

前面本来应该进行的行内代码边界规范化也没有完成。

因此:

Plaintext
`(x+y)/2`、`x*y`

最终被 legacy present 解析器识别成了一个 program span。

于是才出现:

expected 9, actual 8

图 2:moretypes/18 中完整行内代码换位暴露恢复边界问题,修复后原历史响应重新校验通过
图 2:moretypes/18 中完整行内代码换位暴露恢复边界问题,修复后原历史响应重新校验通过

三、修复方式:按照响应中的实际位置处理,而不是假定源顺序永远不变

既然当前设计本来就允许完整行内代码 pair 为适应目标语言语序发生换位,那么恢复逻辑也应该遵守同样的原则。

最终修改后的算法不再按照源顺序串行搜索全部 pair,而是:

  1. 独立查找每一个合法 opening / closing pair;
  2. 获取它们在模型响应中的实际位置;
  3. 按实际位置重新排序;
  4. 根据真正的相邻关系计算是否需要补 ASCII 空格;
  5. 再统一执行边界规范化。

与此同时,原来的严格校验并没有放松。

以下情况仍然必须拒绝:

  • token 缺失;
  • token 重复;
  • 开闭标记不匹配;
  • pair 交叉;
  • pair 内容被修改。

也就是说:

放宽的是“完整结构出现的顺序”,而不是结构完整性本身。

修复完成后,没有重新调用 GLM-5.2,而是直接把 moretypes/18 已经保存的 3 份历史响应重新送入恢复和统一 candidate 校验。

结果三份全部能够恢复出 9 个行内代码,并通过校验。

随后通过正式的 translate revalidate-response 流程,选择最早的 attempt-001 恢复 candidate,最终把:

blocked → ready

而模型的原始 response 一个字都没有改。

这正是我希望这个项目具备的能力:

如果失败来自翻译基础设施,而不是译文本身,就修基础设施,然后让原始历史响应重新进入统一校验,而不是人工篡改结果让某一个页面“过关”。


四、methods/17:第二次遇到“完整结构换位”

到了第 7 批,又出现了一个非常相似的问题。

methods/17 的原始内容包括两个链接:

Plaintext
[[/pkg/fmt/#Stringer][`Stringer`]]

以及:

Plaintext
[[/pkg/fmt/][`fmt`]]

英文表达大致是:

Plaintext
Stringer defined by fmt

而自然的中文表达显然更倾向于:

Plaintext
由 fmt 包定义的 Stringer

因此模型在第三次尝试中,将两个完整链接结构交换了位置。

旧校验器看到的源顺序是:

/pkg/fmt/#Stringer → /pkg/fmt/

而候选译文中的顺序变成:

/pkg/fmt/ → /pkg/fmt/#Stringer

于是报告:

link targets mismatch at index 1

一开始看起来像是:

模型把 /pkg/fmt/#Stringer 错误改成了 /pkg/fmt/。

但检查完整结构后才发现,并没有。

模型实际上仍然保持了:

  • /pkg/fmt/#Stringer 对应 Stringer
  • /pkg/fmt/ 对应 fmt

两个链接目标都没有丢失,没有被修改,也没有与错误的链接文本配对。

只是两个完整链接为了中文语序交换了位置。

图 3:methods/17 中两个完整链接按中文语序换位,修正校验逻辑后历史响应成功恢复
图 3:methods/17 中两个完整链接按中文语序换位,修正校验逻辑后历史响应成功恢复

五、不能简单把链接目标改成无序集合比较

这次修复还有一个需要格外小心的地方。

既然两个链接可以整体换位,是不是直接把:

link target

改成无序集合比较就可以?

不行。

因为仅仅确认:

  • /pkg/fmt/#Stringer 存在;
  • /pkg/fmt/ 存在;

还不够。

假如模型错误地生成:

  • /pkg/fmt/ → Stringer
  • /pkg/fmt/#Stringer → fmt

那么两个 target 虽然一个都没少,却已经发生了错误配对。

因此新的校验逻辑采用的并不是简单 target 集合,而是把完整链接身份考虑进去。

对于包含受保护行内代码 payload 的链接,使用类似:

target + link 内 inline-code payload 多重集合

作为完整 link identity,再进行无序比较。

这样就能够同时满足两个要求:

允许:

完整链接结构整体换位。

但仍然拒绝:

target 与链接文本交叉错配。

而普通没有受保护 payload 的链接仍然保留原来的顺序校验,并没有无条件把所有链接都变成无序比较。

修复后,methods/17 的 attempt-003 历史响应直接通过统一 candidate validation。

随后同样使用正式 revalidate-response 恢复:

blocked → ready

整个过程也没有重新调用 GLM-5.2。


六、这两个问题其实指向同一条设计原则

moretypes/18 和 methods/17 表面看是两个完全不同的问题。

一个是行内代码:

Plaintext
[]uint8
[][]uint8

一个是完整链接:

Plaintext
Stringer
fmt

但它们背后的根因完全一致:

源语言结构顺序不能被误认为目标语言必须保持的语义约束。

最初为了保证翻译安全,我们不断增加 Protected Token、结构签名以及各种校验。

这些保护本身当然有价值。

但是当校验规则开始默认:

A 在英文里出现在 B 前面,那么中文里 A 也必须永远出现在 B 前面。

保护机制本身就可能制造新的误判。

这两次修复最终形成的原则是:

结构身份必须保持,结构内部绑定关系必须保持,但完整结构之间允许按照目标语言的自然语序重新排列。

这比简单地“放宽顺序限制”更准确。

我们并没有降低结构安全要求,而是在区分:

  • 什么才是真正不可破坏的结构;
  • 什么只是源语言表达顺序带来的偶然排列。

这对未来增加日语或其他语言也非常重要。


七、最后 28 页反而变得非常稳定

这两个边界问题解决以后,剩余页面推进速度明显加快。

第 6 批中,只有 methods/6 第一次出现一个 Protected Token 缺失,第二次通过;这是正常的模型重试场景。

第 8 批的 10 个页面:

  • methods/18
  • methods/19
  • methods/21
  • methods/22
  • methods/23
  • methods/25
  • methods/26
  • generics/2
  • generics/3
  • concurrency/1

全部 attempt-001 一次通过。

最后剩余的 8 个页面:

  • concurrency/2
  • concurrency/3
  • concurrency/4
  • concurrency/5
  • concurrency/6
  • concurrency/8
  • concurrency/9
  • concurrency/10

同样全部首轮通过。

至此,状态正式来到:

  • ready=103
  • pending=0
  • blocked=0

最终提交:

584ce7d6f22c68f983d4199deee8f36aec450be5

并已经推送到项目仓库。


八、103 页到底是不是全部页面?

完成 103 / 0 / 0 之后,我突然又想到一个问题:

A Tour of Go 中还有 #appengine: 条件内容,那么实际课程页面会不会不止 103 页?

这个问题值得认真确认。

因为如果状态文件本身就是从一个不完整的页面集合建立出来的,那么:

pending=0

也不能证明真的全部翻译完了。

于是我重新从当前固定的官方 upstream 源码核对页面拓扑。

当前上游基线:

master@e11dacba76c5aae474746e9eedee19693f492803

A Tour of Go 使用 7 个 .article 文件:

  • basics.article
  • concurrency.article
  • flowcontrol.article
  • generics.article
  • methods.article
  • moretypes.article
  • welcome.article

重新统计顶层 Section 后得到:

  • 普通顶层 Section:101
  • #appengine 条件顶层 Section:2
  • 总计:103

两个条件顶层 Section 都位于 welcome.article:

  • Go offline (optional)
  • The Go Playground

虽然 concurrency.article 和 flowcontrol.article 中同样存在 #appengine: 条件内容,但它们只是现有页面内部的条件正文,没有形成新的顶层 Section,因此不会增加课程页面数量。

换句话说:

101 + 2 = 103

这次才真正从官方源码层面确认:

当前 ready=103 确实对应当前上游基线下完整的 A Tour of Go 课程页面集合,而不是只把一个不完整的状态表处理完了。

图 4:上游源码确认共有 103 个课程页面,zh-CN 最终达到 ready=103、pending=0、blocked=0
图 4:上游源码确认共有 103 个课程页面,zh-CN 最终达到 ready=103、pending=0、blocked=0

九、现在完成的是“翻译阶段”,还不是“发布完成”

到这里,A Tour of Go 多语言翻译项目第一阶段中的课程正文翻译已经完成。

当前可以明确确认:

  • 103 个课程页面全部存在;
  • 103 个页面全部完成 zh-CN 翻译;
  • 所有页面均经过相同的 Protected Token 恢复流程;
  • 所有页面均经过 present 解析;
  • 所有页面均经过结构比较;
  • 所有 candidate 均经过统一页面校验;
  • pending=0;
  • blocked=0;
  • 工作区干净;
  • 最终翻译结果已经提交并推送。

不过项目还没有到正式发布的时候。

接下来要进入的是另一个阶段:

zh-CN 发布前全局验收。

它关注的重点将不再是“某个页面有没有翻译成功”,而是整个站点作为一个完整产品是否已经具备发布条件,例如:

  • 103 页最终构建结果;
  • 页面导航与课程拓扑;
  • 浏览器实际渲染;
  • 公共 UI 文案;
  • 链接与静态资源;
  • 右侧 Go 示例;
  • 单语言构建产物;
  • 生产环境部署方式;
  • 本地 /socket 代码执行接口的生产边界;
  • 最终发布前的整体回归。

因此我暂时不会把现在的状态称为“中文版已经完成”。

更准确的说法是:

A Tour of Go 简体中文的 103 个课程页面已经全部完成翻译并进入 ready,课程正文翻译阶段正式结束。

下一步,再开始发布前的全局验收。


十、阶段总结

从最初开始设计这个项目时,我并不希望最终得到的只是:

调用大模型,把英文批量换成中文。

真正困难的部分一直是:

怎样允许模型正常使用中文表达能力,同时又能证明代码、链接、指令、页面结构等关键内容没有被破坏。

而真实跑完 103 页之后,反而更加确认了这一点。

如果保护太少,模型可能破坏结构。

但如果保护和校验过于机械,又会把正常的中文语序调整判定为错误。

moretypes/18 与 methods/17 正好分别从恢复阶段和校验阶段证明了这一点。

最终得到的不是“中文必须服从英文顺序”,而是一套更加明确的边界:

真正不可翻译、不可破坏的内容必须严格保持;完整受保护结构之间,则应该允许为了目标语言自然表达而调整顺序。

现在,当前 upstream 基线下的 103 个页面已经全部跑过了这套流程。

ready=103。

pending=0。

blocked=0。

课程正文翻译阶段,到这里终于可以告一段落了。

A Tour of Go 多语言翻译实战:第三批 10 页全部 Ready,继续校准 Protected Token 的结构角色 ChatGPT 连接 GitHub 实测:让 AI 直接读取 go-tour-i18n 仓库参与译文审核

A Tour of Go 多语言翻译项目

本系列完整记录 A Tour of Go 多语言翻译项目从架构设计、整页翻译、结构保护、自动校验,到生产发布与后续维护的实际开发过程。

项目入口:
✅ Brazilian Portuguese — Português (Brasil)
✅ Dutch — Nederlands
✅ French — Français
✅ German — Deutsch
✅ Italian — Italiano
✅ Japanese — 日本語
✅ Korean — 한국어
✅ Simplified Chinese — 简体中文
✅ Spanish — Español
✅ Turkish — Türkçe
✅ 项目源码:GitHub:shuijingwan/go-tour-i18n

项目正在持续扩展更多语言版本,并长期维护翻译质量、生产发布与后续更新。项目属于非官方社区多语言翻译项目,与 Go 官方无隶属或授权关系。