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

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

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

作者:

在

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:阿拉伯语版本上线,以及我踩过的几个坑

多语言项目应该先做哪些语言?我的 66 个语言版本商业优先级排序

(74) 多语言项目应该先做哪些语言?我的 66 个语言版本商业优先级排序

当术语一致性遇到性能瓶颈:Go 多语言翻译项目的一次架构取舍

(75) 当术语一致性遇到性能瓶颈:Go 多语言翻译项目的一次架构取舍

从 A Tour of Go 走向 Go Learning & Documentation:为什么这个多语言项目需要 v2

(76) 从 A Tour of Go 走向 Go Learning & Documentation:为什么这个多语言项目需要 v2

Markdown 明明可以拆成很多段,为什么 v2 仍然坚持一个 Page 就是一个 TranslationUnit

(77) Markdown 明明可以拆成很多段,为什么 v2 仍然坚持一个 Page 就是一个 TranslationUnit

Tour、Learn、Docs 为什么不应该各维护一份术语表:v2 的统一 Glossary 设计

(78) Tour、Learn、Docs 为什么不应该各维护一份术语表:v2 的统一 Glossary 设计

v2 术语表变更后的页面影响范围判断流程:区分 Compatible 与 Affected,只处理真正受影响的页面。

(79) 术语表改了,为什么不应该让所有页面重新翻译?v2 的影响范围判断

CLI 性能优化示意图:通过 Prepare Once、Reuse Many Times,将执行时间从 6m54.554s 降至 10.335s,约提升 40.1 倍。

(80) 从 6 分 54 秒到 10.3 秒:Go 多语言项目一次 CLI 性能优化实战

Markdown Page 经过 Parse / Protect、Generation 和 Reconstruct / Validate 的流程示意图,强调保护 inline code、链接、代码等机器语义,同时允许译文按照自然语言调整语序。

(81) Markdown 不是纯文本:Learn / Docs 为什么需要新的 parser 与结构保护

历史为什么值得保留:复用已经完成的翻译成果,而不是重新做一遍

(82) 历史为什么值得保留:复用已经完成的翻译成果,而不是重新做一遍

历史状态通过 Trusted Checkpoint 建立可信断点,旧记录继续保留用于审计和诊断,后续工作流从当前状态继续向前,不再要求无限重建过去。

(83) 历史应该被保留,而不是被反复重建:v2 为什么最终需要一个“断点”

v2 依赖与失效传播流程图:从内容变化开始,评估依赖关系和真实影响,将结果区分为“仍然有效”和“需要失效”,只让真正受影响的状态重新进入流程。

(84) 一次内容变化,到底应该让哪些状态失效?v2 的依赖与失效传播设计

v2 本地内容覆盖判断流程图:官方英文页面先检查是否已有正式本地覆盖,有覆盖时使用本地 URL,没有覆盖时直接链接 go.dev,并保持本地路径真实 404。

(85) 有英文页面,不代表一定应该有本地页面:v2 如何处理本地内容覆盖、canonical 与真实 404

v2 代码注释完整性审计流程图:从源页面建立代码块清单,分类教学注释、机器语义和无法判断的内容,再与当前译文精确对应,确认 missing、extra 和 protected mutation 均为 0。

(86) 代码块里的注释为什么不能只靠肉眼检查?v2 如何统计并验证代码注释翻译完整性

结构化语义输入扩展示意图:同一份 books.yaml 原始文件保持不变,旧 parser 识别 10 个可本地化单元,当前 parser 识别 12 个,并新增 PDF 和 GitHub,确认旧单元无删除无修改后重新进入 Generation。

(87) 原始文件一个字没变,为什么还要重新翻译?从 books.yaml 10→12 看语义输入扩展

v2 Activation 流程图:Surface PASS 后先执行只读 activation-preflight 获取 prior_sha256,activation-apply 时通过 CAS 再次比较当前状态,只有 current 等于 prior 才提交 result_sha256,否则停止并重新 preflight。

(88) 审核都通过了,为什么上线前还要再检查一次?v2 的 Activation、prior SHA 与 CAS 设计

v2 分层验证流程图:TranslationUnit、Package Closure 和 Integrated Surface 均通过后进入 Activation,再由 Preview 检查 LoadContent、Compose、Resolver 和 Renderer 的真实运行链;如果实际使用错误 renderer,即使前置内容全部通过,Preview 仍然失败。

(89) Surface 已经 PASS,为什么 Preview 还是会失败?从一次 wrong renderer 看分层验证的价值

更快不一定更好:为什么我主动撤销了一次已经明显变快的性能优化

(90) 更快不一定更好:为什么我主动撤销了一次已经明显变快的性能优化

TranslationUnit 同类问题完整性示意图:左侧 Reviewer 只列出 3 个 examples,Generation 只修这 3 处后仍留下 5 个同类问题,re-QC 再次判 B;右侧 Reviewer 明确 defect category 和 bounded scope,Generation 执行 same-class complete sweep,最终同类残留为 0 并进入 re-QC A。

(91) 为什么修完 Reviewer 指出的所有例子,下一轮还是会失败?从 B→revision→B 看同类问题完整性

immutable source 与 replacement successor 示意图:左侧直接把旧 canonical source A 覆盖成 source B,会使旧 Generation、Review 和 Closure evidence 失去准确对应;右侧保留 source A 作为 immutable predecessor,为新正文建立 source B successor,并重新进入 corpus、glossary review、Generation、QC、closure、Surface 和 Activation 生命周期。

(92) 页面明明是我自己的,为什么不能直接重写?从 /translation/ 改版看 immutable source 与 replacement successor

protected representation 修订能力示意图:左侧 http.Client 被正确保护为 token;中间普通自然语言 Documentation 被错误保护为 opaque token,导致合法 revision 被阻塞;右侧保留旧 representation,通过 representation successor 建立新的可编辑表示,再继续 Generation 和独立 re-QC。

(93) 保护机制也会保护错东西:为什么一个 Documentation 能阻塞整页修订?

一个候选快照原本只应包含 1 个首页翻译单元,却因内容包范围未显式绑定而错误纳入 122 个翻译单元;通过 --content-package site-v2-shell 明确内容包后恢复到正确范围。

(94) 一个候选快照为什么突然多出 122 个单元?从隐式范围到显式内容包契约

Shell 自动化中,当前性检查命令失败并打印 RESULT=FAILED,但由于顶层子 Shell 中错误使用 return,后续命令仍继续执行,最终又打印出错误的 RESULT=PASS。

(95) 命令明明失败了,为什么最后还是 PASS?一次 Shell 自动化的 fail-closed 教训

最近一段时间,我一直在思考一个问题:

网站接下来还能从哪里获得新的流量增长?

过去,我原本比较看好英文站。

我的计划是逐步把一部分已有的中文历史文章翻译成英文,通过扩大英文内容规模,让网站获得更多海外搜索流量。我最初甚至希望,这件事情能够带来大约 30% 的流量增长。

但实际运行一段时间以后,目前看到的增长大约只有 10%。

广告收入也没有出现特别明显的提升。

不过,现在显然还不能因此认为英文站的方向没有价值。

一方面,英文站上线时间还不算长,搜索引擎发现、收录和重新建立排名都需要时间。

另一方面,目前英文站的历史文章翻译质量并不完全一致。

早期我先后尝试过 AutoPoly、Chrome 内置 AI、Yandex 等不同翻译方案,后来经过多轮实际测试,才最终确定使用 GLM-5.2 作为目前主要的整篇翻译模型。

因此,现在仍然有相当一部分历史英文文章并不是由 GLM-5.2 翻译的。

我目前正在逐步对这些历史文章重新执行 GLM-5.2 覆盖翻译。

所以,现阶段英文站的流量和广告收入表现,本身仍处于一个不断调整的阶段。

但是,这件事情也让我开始思考另一个方向:

如果只是不断把已经存在的中文内容翻译成英文,短时间内想让网站流量出现明显增长,可能并不容易。

相比之下,如果能够发现一个已经存在明确搜索需求、但现有内容供给恰好出现问题的方向,也许更值得投入时间。

最近,我恰好发现了这样一个机会。

一、从一个真实搜索关键词开始

最近查看网站的 Google 搜索自然查询数据时,我发现了一个很有意思的关键词:

A Tour of Go 中文版

它目前只产生了 1 次展示和 1 次点击,数据量非常小。

但对我来说,真正重要的并不是这 1 次点击,而是这个关键词让我开始关注:

现在还有没有人在搜索 Go Tour 的中文版本?

图1:网站 Google 搜索自然查询中出现了「a tour of go 中文版」,虽然目前只有 1 次展示和 1 次点击,但它成为这次项目构想的起点。
图1:网站 Google 搜索自然查询中出现了「a tour of go 中文版」,虽然目前只有 1 次展示和 1 次点击,但它成为这次项目构想的起点。

我平时本来也在持续复习和加强 Go 相关知识,所以看到这个搜索词以后,顺手去搜索了一下当前的 Go Tour 中文版本。

结果发现了一件很有意思的事情。

二、Go 官方仍然保留着简体中文入口

Go 官方目前仍然提供 A Tour of Go:

https://go.dev/tour

在 Tour 的语言选择页面中,目前依然可以看到:

Simplified Chinese — 中文(简体)

也就是说,至少从官方页面本身来看,简体中文版本并没有从语言列表中消失。(Go)

图2:Go 官方 A Tour of Go 的语言选择页面,目前仍然保留「Simplified Chinese — 中文(简体)」入口。
图2:Go 官方 A Tour of Go 的语言选择页面,目前仍然保留「Simplified Chinese — 中文(简体)」入口。

这让我自然地点开了这个链接。

它指向过去的中文 Go Tour:

tour.go-zh.org

但现在已经无法正常访问。

三、官方中文入口还在,但目标站已经失效

实际访问 tour.go-zh.org 时,目前无法正常打开。

我这里访问时,Firefox 最终显示:

建立安全连接失败

错误代码为:

PR_END_OF_FILE_ERROR

而从服务器请求结果来看,目前这个域名也无法正常提供 Tour 页面。

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

这就形成了一个比较有意思的状态:

Go 官方仍然展示简体中文入口,但过去对应的中文站已经无法正常使用。

与此同时,我的网站又实际出现了:

A Tour of Go 中文版

这样的搜索查询。

虽然单次数据远远不能证明存在多大的搜索市场,但至少说明:

这个需求并没有完全消失。

而且它和单纯把自己已有的博客内容翻译成另一种语言,有一些本质上的不同。

前者更像是:

已有中文文章 → 翻译成英文 → 等待新的英文搜索流量。

而 Go Tour 中文版这个方向则是:

用户已经存在相关搜索 → 现有中文入口失效 → 尝试补上这个缺口。

这也是我决定进一步研究这个项目的主要原因。

四、最开始,我只是想重新部署旧的中文版

刚发现这个问题的时候,我的想法其实很简单:

既然以前已经有人做过中文版,是不是直接把旧仓库重新部署起来就可以了?

我也确实找到了相关的历史开源项目。

如果只是为了让网站重新能访问,这显然是最快的方案:

找到旧源码,部署到服务器,配置域名,再接入 CDN。

几乎不需要重新开发。

但继续考虑以后,我逐渐觉得,这并不是一个好的长期方案。

问题并不是:

今天能不能把这个网站重新跑起来。

真正的问题是:

以后官方 A Tour of Go 更新了怎么办?

如果直接使用几年前停止维护的中文项目,那么很可能出现:

官方 Tour 不断更新,而中文版继续停留在过去版本。

几年以后,又会重新遇到今天看到的问题。

所以,我逐渐把目标从:

恢复旧 Go Tour 中文版

调整成了:

重新建立一个能够持续跟随官方版本维护的简体中文 Go Tour。

五、我更关心的不是第一次翻译,而是以后怎么维护

一次把整个 Tour 翻译成中文,其实并不是最困难的事情。

真正麻烦的是:

官方以后更新了怎么办?

例如官方修改一个章节。

中文版需要知道:

这段英文发生过变化;

当前中文译文对应的是旧内容;

因此需要重新翻译;

翻译完成以后还需要重新检查。

所以我希望未来建立的并不是一次性的翻译流程,而是一套持续维护机制。

基本思路是:

官方 Go Tour 更新 → 检测英文内容变化 → 找出需要重新翻译的部分 → 调用 GLM-5.2 → 自动验证 → 人工审核 → 更新中文版本。

这里 GLM-5.2 负责的核心工作只有一个:

翻译。

而程序负责决定:

哪些内容发生了变化;

哪些内容应该翻译;

哪些内容不能修改;

译文是不是已经过期;

代码是否发生变化;

页面结构是否仍然完整;

翻译结果是否符合要求。

这和我过去一段时间不断完善 WordPress AI 翻译流程的思路其实比较接近。

只不过这一次,目标从:

WordPress 中文文章 → 英文

变成:

官方 Go Tour 英文 → 简体中文。

六、为什么选择 GLM-5.2

这个选择并不是项目开始以后再决定的。

因为过去一段时间,我已经围绕 WordPress 历史文章翻译测试过多种方案。

从早期的 AutoPoly,到 Chrome 内置 AI,再到 Yandex 等方案,最后经过多轮实际测试以后,目前整篇内容翻译已经逐渐统一到 GLM-5.2。

与此同时,我还处理过不少 AI 翻译中很容易出现的问题,例如:

代码块不能被错误翻译;

HTML 和 Gutenberg 结构不能被破坏;

技术名词需要保持一致;

特殊结构需要保护;

翻译以后还要做完整性验证;

失败任务要能够重新执行。

这些经验正好可以迁移到 Go Tour 中文版。

而且相比复杂的 WordPress Gutenberg 内容,Go Tour 的内容结构反而更加规整。

因此,这次没有必要再从头重新比较一轮翻译模型。

第一版直接使用:

GLM-5.2。

七、这个项目本身也可以用 Go 来实现

既然目标是 Go Tour,我也希望项目自身尽可能使用 Go。

例如:

官方内容同步;

版本差异检测;

文件解析;

GLM-5.2 API 请求;

翻译状态管理;

结构验证;

术语校验;

CLI;

Web 服务;

最终都可以逐步使用 Go 实现。

这件事情还有一个额外价值。

我平时本来也需要持续复习和加强 Go,而相比单独写一些为了演示语法而存在的 Demo,一个真正需要长期运行的项目显然更适合系统地回顾各种 Go 能力。

例如后面很自然会涉及:

HTTP Client、JSON、文件处理、错误处理、测试、context、goroutine、channel、并发控制、Web Server 等。

这些能力不是为了“练习某个语法”而强行加入项目。

而是项目发展到一定阶段以后,本身就会需要。

所以这个项目最终可能同时承担两个作用:

维护 Go Tour 中文版。

以及:

作为一个长期的 Go 实战项目,用于持续复习和加强 Go。

八、Gin 暂定使用,但不急着重写 Tour

既然决定以 Go 为主要开发语言,Gin 自然也是一个很容易想到的选择。

未来如果做翻译管理 API,例如查看翻译状态、触发重新翻译、查看 upstream 差异等,Gin 很适合处理这些 Web/API 功能。

但是我目前不准备一开始就使用 Gin 重写整个 Go Tour。

原因也很简单:

官方 A Tour of Go 本身就是 Go 项目。

在还没有仔细阅读官方源码以前,直接决定把它重写成 Gin,并没有太大意义。

所以目前的顺序是:

先把官方最新版源码拉下来;

先运行;

再阅读代码;

弄清楚它现有的 Web Server、路由、模板、课程数据和代码运行机制;

最后再决定 Gin 应该放在哪一层。

Gin 很可能最终主要用于:

翻译管理;

内部 API;

状态查询;

同步管理。

而 Tour 本身则尽可能沿用官方已有实现。

这样未来跟随 upstream 更新时,也能减少不必要的修改。

九、中文版域名暂定为 zh.go-tour.shuijingwanwq.com

域名也经历了几次变化。

最开始考虑的是:

tour.shuijingwanwq.com

后来又考虑:

go-tour.shuijingwanwq.com

以及:

go-tour-zh.shuijingwanwq.com

目前我更倾向:

zh.go-tour.shuijingwanwq.com

这里可以理解为:

zh 代表语言;

go-tour 代表项目;

shuijingwanwq.com 则属于现有网站体系。

这样未来如果真的存在其他语言,也可以自然扩展。

例如:

ja.go-tour.shuijingwanwq.com

ko.go-tour.shuijingwanwq.com

当然,目前只是从域名和架构上留下这种可能。

第一阶段只做:

简体中文。

英文版没有必要自己再维护一份,因为官方 A Tour of Go 本身就是英文原版。

十、中文站计划继续使用 EdgeOne

这个项目主要面向中文 Go 用户。

因此,与英文站不同,zh.go-tour.shuijingwanwq.com 第一阶段计划使用 EdgeOne,而不是 Cloudflare。

预计的生产链路是:

用户 → EdgeOne → Nginx → Go 服务

原因主要还是中国大陆访问体验。

这个站未来想承接的搜索需求本身就是:

A Tour of Go 中文版

Go Tour 中文

Golang Tour 中文

等中文关键词。

因此,中文站从第一天开始就应该把中国大陆访问体验作为主要考虑因素之一。

而 CDN 与应用本身保持独立即可。

Go 服务并不需要知道前面究竟使用 EdgeOne、Cloudflare 还是其他 CDN。

十一、中文版的目标不是重新创造一个 Go Tour

关于中文版的内容,我目前反而希望保持克制。

我不准备为了让中文站看起来“更丰富”,就大量加入:

中文学习提示;

额外教程;

自定义知识点;

大量原创扩展。

至少这个项目的核心目标不是这些。

我更加希望:

中文版尽可能和官方英文版本保持一致。

官方有多少章节,中文版就对应多少章节。

官方修改什么,中文版跟随修改。

官方没有的内容,原则上不随意加入。

真正需要重点投入的是:

翻译是否准确。

技术术语是否统一。

代码是否保持原样。

内容是否对应当前官方版本。

官方更新以后能不能及时发现并同步。

即使未来需要增加少量中文版本特有内容,也应该尽量限制在必要的翻译说明、版权信息、版本信息和非官方声明等范围内,而不是改变 Tour 本身的教学内容。

我更希望它最终成为:

一个忠实、准确、持续维护的 A Tour of Go 简体中文版本。

十二、翻译状态不能只有“有中文”和“没中文”

如果目标是长期同步官方版本,那么还需要解决一个很重要的问题:

怎么知道现有译文对应的是哪一版英文?

例如某一段英文今天完成翻译。

半年以后,官方修改了这一段。

即使中文文件依然存在,它也已经不能简单算作:

“翻译完成”。

它实际上应该变成:

译文已过期。

所以以后很可能需要记录:

源内容版本;

源内容 Hash;

翻译对应的源版本;

翻译状态;

审核状态。

最基本的状态可以类似:

new

translated

reviewed

outdated

官方英文一旦发生变化,就自动把对应中文译文标记为 outdated。

这样项目才能真正长期跟随 upstream,而不是靠人工记忆判断哪些地方发生过变化。

十三、术语统一也应该由程序帮助保证

Go 教程里有大量固定技术词汇。

例如:

slice

map

interface

method

receiver

goroutine

channel

如果完全让模型自由翻译,不同页面之间很容易出现不同表达。

所以项目第一阶段就可以建立一份简体中文术语表。

它一方面可以加入 GLM-5.2 的翻译规则;

另一方面,也可以提供给 Go 程序执行自动检查。

这样能够尽量保证:

同一个 Go 概念,在整个 Tour 中保持统一表达。

这里仍然遵循一个原则:

尽量忠实于官方内容,而不是重新解释官方内容。

十四、第一阶段暂时不把广告作为上线条件

这个项目的起点,确实与流量增长和广告收入有关。

如果以后 A Tour of Go 中文版 能够持续获得搜索流量,自然也可以评估商业化。

但是第一阶段,我不准备把:

接入广告

作为项目上线条件。

首先要验证的是:

中文站能不能正常运行;

翻译流程是否可靠;

Google 是否正常收录;

相关中文搜索词有没有持续展示;

用户是否真的会使用中文版 Tour。

只有这些基础问题得到验证以后,再考虑广告更合理。

也就是说,第一阶段的重点还是:

先把产品做出来,并验证真实需求。

十五、这一次准备主要在 VS Code 中开发

这个项目还有一个和最近很多自动化项目不同的地方:

我准备主要在 VS Code 中完成开发。

过去一段时间,我已经大量使用 Codex 和其他 AI 编程工具。

对于服务器排查、WordPress 自动化、批处理工具等任务,这种方式能够明显提高效率。

但是 Go Tour 中文版除了最终结果以外,我还希望利用整个开发过程重新系统地梳理 Go。

所以这一次,我希望自己更多地:

阅读源码;

查看类型;

跟踪调用关系;

使用 Go to Definition;

使用 Find References;

查看测试;

Debug;

分析 Git diff;

理解项目为什么这样设计。

AI 和 Codex 仍然会继续使用。

但角色会有所变化。

相比直接让 AI 一次完成整个模块,我更倾向:

让 AI 辅助分析、解释、Review 和处理具体问题,而开发过程本身尽可能保持可阅读、可理解。

项目推进速度可能会慢一些。

但从长期来看,这个过程本身就是项目价值的一部分。

十六、第一阶段只做一个很小的 MVP

现在没有必要直接翻译整个 A Tour of Go。

第一阶段只需要验证这条路线能不能跑通。

暂定目标包括:

  1. 获取当前官方 A Tour of Go 源码;
  2. 在本地正常运行;
  3. 使用 VS Code 阅读核心代码结构;
  4. 确定 upstream 与中文项目之间的组织方式;
  5. 建立自己的 Go 项目;
  6. 使用 Go 跑通 GLM-5.2 API;
  7. 完成少量页面的中文翻译;
  8. 建立基础自动校验;
  9. 部署 zh.go-tour.shuijingwanwq.com;
  10. 接入 EdgeOne;
  11. 等待搜索引擎收录;
  12. 观察真实搜索表现。

第一阶段甚至没有必要翻译几十个页面。

先完成几个页面,把整个:

官方源码 → 翻译 → 校验 → 发布

的链路跑通。

然后再决定是否全量推进。

十七、整个过程还可以形成一个新的博客系列

这个项目还有一个额外的价值。

从最初发现搜索关键词,到源码阅读、翻译系统开发、部署、CDN、SEO 和后续流量验证,整个过程本身就可以持续记录。

后续可以包括:

第一次运行最新版 A Tour of Go;

官方 Go Tour 源码结构分析;

如何设计中文本地化架构;

Go 调用 GLM-5.2 API;

Go 实现翻译状态管理;

如何保护 Go 源码不被 AI 翻译;

如何检测 upstream 更新;

如何判断译文已经过期;

Gin 最终在项目里承担什么职责;

Go 服务生产部署;

EdgeOne 接入;

中文版上线后的搜索收录;

A Tour of Go 中文版 是否真的带来了新增流量。

这样一来,开发本身也会持续产生新的博客内容。

项目推动内容更新,内容又可以继续为网站带来新的搜索入口。

十八、结语

这次项目的起点其实非常简单。

我只是在网站的 Google 搜索自然查询里发现:

A Tour of Go 中文版

产生了一次展示和一次点击。

顺着这个关键词继续看下去,又发现:

Go 官方目前仍然保留着简体中文入口,但过去对应的中文站已经无法正常使用。

于是最开始那个:

要不要把旧中文版重新部署一下?

的想法,逐渐演变成了现在的计划:

基于当前官方 A Tour of Go,重新建立一个能够持续同步、GLM-5.2 辅助翻译、Go 程序自动校验并经过人工审核的简体中文版本。

它希望解决的是一个非常明确的问题:

让 A Tour of Go 重新拥有一个准确、可用,而且能够持续跟随官方更新的简体中文版本。

与此同时,我也希望借这个项目重新系统地复习和加强 Go,把 HTTP、Web、并发、测试、CLI、自动化等内容放到一个真正长期运行的项目里重新串起来。

至于它最终能不能获得预期的搜索流量,现在还不知道。毕竟目前看到的也只是一个很小的搜索信号。但和单纯猜测一个方向不同,这一次至少有一个真实的起点:已经有人搜索了它。 下一步,我准备先把当前最新版 A Tour of Go 源码拉到本地,在 VS Code 中打开项目,先看看这个已经运行多年的官方 Go 项目,到底是怎么实现的。

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

Go 学习与文档多语言本地化项目

本系列完整记录 Go 学习与文档多语言本地化项目从 A Tour of Go 起步,逐步扩展到站点首页、项目说明页、学习内容、文档以及未来内容包的实际开发过程,包括架构设计、统一术语治理、整页翻译、结构保护、自动校验、独立质量审核、生产发布与长期维护。

项目源码:
✅ GitHub:shuijingwan/go-tour-i18n

语言版本:

当前跨项目目标语言池共包含 66 个语言版本。Go 项目本身目前提供 65 个社区 Production 语言版本,下面每一门 Go 语言版本都直接链接到其当前公开站点。语言列表沿用项目首页现有的展示顺序。

英语(美国)仅作为跨项目目标语言纳入列表,并不是单独的 Go Production 语言版本。当前 Go 的英文源内容仍为官方 generic English,因此英语(美国)链接到 Go 官方站点,而不是不存在的本地社区部署。

  1. 阿姆哈拉语
  2. 阿拉伯语
  3. 孟加拉语
  4. 葡萄牙语(巴西)
  5. 保加利亚语
  6. 加泰罗尼亚语
  7. 克罗地亚语
  8. 捷克语
  9. 丹麦语
  10. 荷兰语
  11. 英语(美国)(Go 官方英文站点)
  12. 英语(澳大利亚)
  13. 英语(加拿大)
  14. 英语(印度)
  15. 英语(新加坡)
  16. 英语(南非)
  17. 英语(英国)
  18. 爱沙尼亚语
  19. 菲律宾语
  20. 芬兰语
  21. 法语(法国)
  22. 法语(加拿大)
  23. 德语(德国)
  24. 德语(奥地利)
  25. 德语(瑞士)
  26. 希腊语
  27. 古吉拉特语
  28. 希伯来语
  29. 印地语
  30. 匈牙利语
  31. 印度尼西亚语
  32. 意大利语
  33. 日语
  34. 卡纳达语
  35. 哈萨克语
  36. 韩语
  37. 西班牙语(拉丁美洲)
  38. 拉脱维亚语
  39. 立陶宛语
  40. 马来语
  41. 马拉雅拉姆语
  42. 马拉地语
  43. 书面挪威语(Bokmål)
  44. 波斯语
  45. 波兰语
  46. 葡萄牙语(葡萄牙)
  47. 旁遮普语(果鲁穆奇文,印度)
  48. 罗马尼亚语
  49. 俄语
  50. 塞尔维亚语(西里尔文)
  51. 简体中文(中国大陆)
  52. 简体中文(新加坡)
  53. 斯洛伐克语
  54. 斯洛文尼亚语
  55. 西班牙语(西班牙)
  56. 斯瓦希里语(坦桑尼亚)
  57. 瑞典语
  58. 泰米尔语
  59. 泰卢固语
  60. 泰语
  61. 繁体中文(台湾)
  62. 繁体中文(香港)
  63. 土耳其语
  64. 乌克兰语
  65. 乌尔都语
  66. 越南语

项目正在持续扩展新的 Go 学习与文档内容,并长期维护各语言版本的术语一致性、翻译质量、独立审核、生产发布与后续更新。

本项目属于非官方社区多语言本地化项目,与 Go 官方无隶属、授权或背书关系。

评论

一条对“从「A Tour of Go 中文版」这个搜索词开始:我决定做一个持续维护的 Go Tour 中文版”的回复