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

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

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

作者:

在

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 多语言项目

【图 4:RTL 桌面课程布局修复后的效果】

(73) 第一次把 A Tour of Go 做成 RTL:阿拉伯语版本上线,以及我踩过的几个坑

最近,我一直在推进 A Tour of Go 多语言翻译项目。

前一阶段已经完成了简体中文 zh-CN 的全部课程正文翻译。按照当前发布口径,一共有 103 个正式发布页面,并且全部通过了项目现有的自动结构和页面校验。

但“自动校验通过”并不等于“可以直接发布”。

自动校验更擅长确认:

  • present 结构是否正确;
  • .play 等指令有没有丢失;
  • 链接目标有没有变化;
  • 行内代码结构是否完整;
  • 强调结构是否保留;
  • 教学代码注释有没有破坏程序结构;
  • candidate 与英文源页面的结构是否一致。

而它很难判断另一类问题:

这句话虽然技术上没错,但中文是不是太绕?

或者:

这个术语虽然能够理解,但是否符合中文 Go 社区更常见的表达?

所以,在 103 个页面全部进入 ready 之后,我没有马上开始发布,而是增加了一轮完整的发布前正文质量审计。

最终结果有点出乎我的预料:

103 页全部逐页审核,真正需要返修的只有 16 页。


一、为什么不让 ChatGPT 把 103 页重新翻译一遍

最简单粗暴的办法,其实是把 103 页全部重新交给 ChatGPT。

但我一开始就不太认可这种做法。

因为当前译文不是未经验证的草稿。

它们已经经过了:

Plaintext
GLM-5.2 整页翻译
→ candidate
→ present 解析
→ protected structure 校验
→ 页面结构比较
→ ready

如果发布前再把 103 页全部重写一次,就意味着:

为了改善少量真正存在问题的句子,把大量本来已经可以发布的内容重新制造一次变化。

而每一次变化,都会重新引入:

  • 链接移动;
  • 行内代码结构变化;
  • 强调结构变化;
  • 指令丢失;
  • 技术含义漂移;
  • 中文风格重新波动。

所以这次审核采用的原则不是:

ChatGPT 能不能写得更好?

而是:

当前页面是否已经足够好到可以发布?

这两个标准差别很大。


二、为 103 页建立 A / B / C / D 四级审核标准

为了避免审核过程中逐渐变成“看到一句话就想重新写一句话”,我先给所有页面设定了四个等级。

A:无需修改

译文:

  • 技术准确;
  • 中文自然;
  • 术语合理;
  • 阅读没有明显障碍。

即使 ChatGPT 能写出另一种表达,也不构成修改理由。

B:可选润色

存在能够明确指出的小优化,但当前版本已经完全可以发布。

这一类原则上不修改。

C:建议修改

存在比较明确的问题,例如:

  • 翻译腔明显;
  • 术语不统一;
  • 英文残留;
  • 表达绕到需要重新读一遍;
  • 虽然技术含义基本正确,但已经影响阅读体验。

D:必须修改

这一类属于真正影响技术含义的问题,例如:

  • 误译;
  • 漏译;
  • 技术概念发生变化;
  • 中文表达容易让读者得到错误理解。

后来在实际审核过程中,我还进一步调整了一个标准:

“技术上没有错”并不能自动得到 A 或 B。

如果一句话已经明显像机器翻译,读者需要重新拆句才能理解,那么即使它最终表达的技术含义基本正确,也应该进入 C。

这个标准后来直接影响了一个很典型的页面。


三、C 类代表:技术没错,但“返回一个返回……”实在太绕

moretypes/26 是一个很有代表性的例子。

这是关于函数闭包和斐波那契数列的练习页面。

原来的译文是:

实现一个 fibonacci 函数,它返回一个返回连续的斐波那契数(0, 1, 1, 2, 3, 5, …)的函数(闭包)。

严格来说,它不是技术误译。

读几遍之后,也能够理解它想表达什么。

问题在于:

“返回一个返回……”

这种嵌套结构非常明显地带有英文句法直接映射到中文后的痕迹。

所以它最终被列为 C,而不是 B。

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

最终改成:

实现一个 fibonacci 函数,使其返回一个函数(闭包),该闭包会依次返回斐波那契数(0, 1, 1, 2, 3, 5, …)。

技术含义完全没有改变。

但是中文的主干一下就清楚了:

Plaintext
fibonacci
→ 返回一个闭包
→ 闭包依次返回斐波那契数

这也是我后来越来越明确的一点:

发布前质量审核不是为了重新翻译,而是为了把真正影响理解的表达修掉。


四、D 类代表:fmt.Println 被错误翻成了 main

相比 C 类,D 类的问题要少得多。

整个 103 页最终只有 2 页 D。

其中一个是 flowcontrol/7。

英文原文的意思是:

对 pow 的两次调用都会在 main 中的 fmt.Println 调用开始之前返回结果。

原来的中文却变成:

在 main 开始执行之前,对 pow 的两次调用都已返回结果……

这两个说法不是一回事。

因为 pow 本身就是在 main 执行过程中被调用的。

如果说:

main 开始执行之前,pow 已经返回。

那执行顺序就完全不成立。

图 2:flowcontrol/7 的技术误译——把 fmt.Println 调用开始之前错误翻成了 main 开始执行之前
图 2:flowcontrol/7 的技术误译——把 fmt.Println 调用开始之前错误翻成了 main 开始执行之前

最终修订为:

在 main 中调用 fmt.Println 之前,两次 pow 调用都会先返回结果。

这一处就属于非常明确的 D:

必须修改。

另一个 D 出现在 moretypes/7。

原来的中文把:

Go
a[1:4]

描述成:

a 的第 1 到第 3 个元素

但 Go 的这个切片实际包含的是:

索引 1、2、3 对应的元素

中文里的“第 1 个元素”通常会被理解成索引 0 的第一个元素。

所以最终统一改成:

a 中索引 1 到 3 的元素

这两个 D 都不是所谓“写得更漂亮”。

而是真正可能影响初学者理解程序行为的问题。


五、审核中途还插入了一次 Go 中文术语校准

本来我以为这轮工作只需要审核 103 页正文。

结果检查到并发课程以后,又发现:

  • 有页面写“信道”;
  • 有页面写“通道”;
  • 还有页面直接保留 channel。

这又引出了一个新问题:

到底应该根据什么决定 Go 中文术语?

后来我没有按照“项目里哪个词出现更多”来决定,而是重新参考中文 Go 社区长期存在的资料,最终冻结了一批项目术语。

例如:

  • channel → 通道
  • type inference → 类型推断
  • untyped constant → 无类型常量
  • untyped numeric constant → 无类型数值常量
  • built-in → 内置

这部分我已经单独整理成上一篇文章,这里不再展开。

但这次术语校准也影响了最终审核统计。

例如 moretypes/15 原来同一个页面同时出现:

内建
内置

两种 built-in 译法。

虽然完全不影响技术理解,但既然发布前术语基线已经决定统一采用:

内置

那么这页也进入 C。

所以最终正式返修数量从最初的 15 页增加到了:

16 页


六、103 页最终到底有多少需要修改

全部页面审核完成,再加上术语校准之后,最终统计是:

Plaintext
A:87
B:0
C:14
D:2

总计:103

真正需要修改:

Plaintext
14 个 C
+
2 个 D
=
16 页

也就是说:

87 / 103 页保持原样。

没有因为 ChatGPT 能给出另一种中文表达,就把它们重新改写。

这其实是这次审核中我比较满意的一点。

如果一轮所谓“发布前人工审核”最终把 103 页中的八九十页都重新写了一遍,我反而会怀疑:

到底是在审核,还是重新翻译?

而现在的结果更接近我希望的状态:

模型负责生产大部分可发布译文,人工审核只找出真正值得干预的少量异常。


七、16 页不是重新调用 GLM,而是做最小精确修订

确定 16 页之后,我没有再调用 GLM-5.2。

而是把每一处修改先固定下来,包括:

  • 当前文本;
  • 最终建议文本;
  • 修改理由;
  • 是否涉及术语表;
  • 是否会影响现有 present 结构。

然后再统一交给 Codex 修改。

这一步有几个严格限制:

  • 不修改另外 87 个 A 页面;
  • 不做顺手润色;
  • 不重新翻译整个页面;
  • 不修改 .play;
  • 不改变链接目标;
  • 不绕过现有 validator;
  • 不处理公共 UI;
  • 不更新项目状态文档。

最终只修改:

16 个 candidate + glossary.yaml

这也是为什么这轮修改最终能够保持非常小的 diff。


八、一个特别有价值的意外:validator 拒绝了我的人工修订

methods/19 是这轮工作里我最喜欢的一个案例。

不是因为它的问题严重,而是因为它真正验证了项目架构。

这个页面原来有一句:

值为 error 的 nil 表示成功;非 nil 的 error 表示失败。

中文明显比较别扭。

我最初给出的修订建议是:

error 为 nil 表示成功;非 nil 则表示失败。

从中文来说,这句话没有任何问题。

甚至比最终采用的版本更简洁。

但 Codex 修改以后,validator 没有通过。

原因是:

英文源结构要求这一句话中保留两个 `error` 行内代码结构,而我的人工建议只留下了一个。

也就是说,我为了让中文更自然,无意间把一个受保护的 inline-code span 删除了。

图 3:人工修订同样不能绕过结构校验,methods/19 因少保留一个行内代码结构被 validator 拒绝
图 3:人工修订同样不能绕过结构校验,methods/19 因少保留一个行内代码结构被 validator 拒绝

最后改成:

error 为 nil 表示成功;非 nil 的 error 则表示失败。

再次运行 validator:

Plaintext
PASS
candidate OK: locale=zh-CN page_id=methods/19

这件事情特别能说明这个项目为什么坚持:

无论译文来自 GLM-5.2、ChatGPT 还是人工修改,都必须经过同一套自动校验。

如果因为一句话是我和 ChatGPT 人工确认的,就直接认为它“当然正确”,那么这次结构变化就不会被发现。

而 validator 不关心:

这句话是谁改的。

它只关心:

candidate 是否仍然满足源页面要求的结构约束。

这正是我希望整个流程具备的性质。


九、教学代码注释也重新经过了专项校验

这轮还有一个比较小但很有代表性的修改出现在 concurrency/6。

正文已经翻译成中文,但 select 示例里还残留两条英文教学注释:

Go
select {
case i := <-c:
    // use i
default:
    // receiving from c would block
}

最终翻译成:

Go
select {
case i := <-c:
    // 使用 i
default:
    // 从 c 接收会阻塞
}

项目之前已经专门实现了对可翻译教学代码注释的保护、恢复和验证。

所以这里也没有因为:

“只是两条注释”

就直接修改后放行。

它仍然完整走了一遍现有 teaching-comment 和结构 validator。

最终通过。

这也再次说明:

可翻译,并不等于可以绕过结构保护。


十、连文件末尾多出来的一个换行也清掉了

16 页全部修改完成以后,我又让 Codex 对 17 个文件做了一次只读 diff 审核。

语义修改都没有问题,但却发现:

有 10 个 candidate 原本文件末尾没有换行,人工编辑之后意外多出了一个 0a 字节。

这当然不会影响 Go Tour 渲染。

也不会导致 validator 失败。

但是它属于纯粹的无意义 diff。

既然这次目标本来就是:

最小、精确修订

那就没有理由把这种变化带进最终提交。

所以又专门把这 10 个文件的 EOF 状态恢复为原始状态。

最终确认:

  • 正文不变;
  • 结构不变;
  • 10 个 EOF 噪声消失;
  • 其余文件没有额外变化。

这类细节本身不重要。

但它能够让最终提交更容易审计:

每一处 diff 都应该回答“为什么要改”。


十一、最终 16 / 16 全部重新通过校验

所有修订完成之后,16 个页面重新运行统一 validator。

最终:

Plaintext
16 / 16 PASS

然后执行完整 Go 测试:

Plaintext
go test ./...

全部通过。

继续检查:

Plaintext
git diff --check

同样通过。

最后这一轮的完整结果是:

图 4:103 页全部完成质量审计,16 个返修页面重新通过统一校验并提交为 5f77081
图 4:103 页全部完成质量审计,16 个返修页面重新通过统一校验并提交为 5f77081

最终摘要:

Plaintext
audited pages: 103 / 103

A: 87
C: 14
D: 2

revised pages: 16 / 16
validator: PASS
go test ./...: PASS
git diff --check: PASS

并提交:

Plaintext
5f77081 fix: 完成 zh-CN 课程正文质量审计修订

提交之后:

Plaintext
working tree: clean

十二、从 103 页 ready 到 103 页经过发布前质量审核

在这之前,项目已经有一个很重要的提交:

Plaintext
584ce7d feat: 完成 zh-CN 全部课程页面翻译

它代表:

103 个正式发布页面已经全部完成翻译,并通过自动校验进入 ready。

而这次新的:

Plaintext
5f77081 fix: 完成 zh-CN 课程正文质量审计修订

代表的是另一个阶段:

103 页全部经过发布前人工质量审计,需要调整的 16 页已经完成修订并重新通过相同的自动校验。

这两个节点的含义并不一样。

第一个回答:

翻译流程是否全部跑通?

第二个回答:

当前译文是否已经经过完整发布前质量检查?

现在,这两个问题都可以回答:

是。


十三、为什么最终“只修改 16 页”反而是一个不错的结果

这次审核之前,我其实不知道最后会改多少。

可能是 10 页,也可能是 50 页。

但最终:

103 页里只有 16 页需要明确修订。

我觉得这个比例反而能够说明前面的翻译流程已经比较稳定。

尤其是:

真正属于技术性错误的 D 类只有 2 页。

其余大部分需要修改的内容都是:

  • 中文明显绕口;
  • 术语不统一;
  • 英文残留;
  • 某个表达不够准确;
  • 某句话虽然能理解,但不适合作为发布版教程正文。

这与项目最初想达到的方向比较接近:

不要求人工逐句重新翻译,但要有能力在发布前发现少量真正异常的页面。

如果以后扩展到其他语言,我也不希望流程变成:

Plaintext
模型翻译 100 页
→ 人工再重新翻译 100 页

那样自动化的意义就很有限。

我更希望它保持现在这种结构:

Plaintext
模型整页翻译
→ 自动结构校验
→ 全量质量审核
→ 只返修明确异常
→ 同一套自动校验
→ 发布

十四、总结

这轮 103 页正文质量审核,最后真正让我印象最深的并不是:

改了多少句话。

而是整个流程开始形成一个比较清楚的闭环。

模型生成译文之后,自动校验负责结构可靠性。

人工审核不负责把所有页面重新写一遍,而只负责判断:

哪些页面真的值得干预。

人工修改之后,也不会因为“这是人改的”就获得特殊待遇,而是重新进入同一个 validator。

最终:

103 页全部审计,87 页原样保留,14 页 C、2 页 D,共返修 16 页。

而那次 methods/19 的失败尤其让我确认:

人工判断和自动校验并不是互相替代,而是互相补充。

人工更擅长发现:

“这句话怎么这么绕?”

validator 更擅长发现:

“你刚才为了让它不绕,把一个必须保留的行内代码结构删掉了。”

两者同时存在,才更接近我希望这个项目最终具备的发布流程。

到这里,A Tour of Go 简体中文的课程正文基本可以认为完成了发布前收尾。

接下来剩下的重点,就不再是 103 个课程页面本身,而是浏览器里的另一层内容:

公共 UI 文案。

例如目前页面中仍然能看到的:

  • Run
  • Format
  • Reset
  • Syntax
  • 上一页 / 下一页相关界面
  • 其他公共交互文字

正文已经完成,下一阶段就轮到它们了。

为什么 channel 最终选择“通道”:A Tour of Go 中文术语统一的一次实践 A Tour of Go 多语言翻译项目:公共 UI 本地化完成,从课程译文走向完整中文界面

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 官方无隶属或授权关系。