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

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

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

作者:

在

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 教训

2026 年 9 月 11 日,我再次打开 Go 官方的 A Tour of Go:

https://go.dev/tour/welcome/2

在 Go local 的语言列表中,已经可以看到:

  • French — Français
  • German — Deutsch
  • Korean — 한국어
  • Simplified Chinese — 简体中文

这 4 个链接,最终都指向了我长期维护的 A Tour of Go 多语言翻译项目。

从结果上看,这件事似乎很简单:向 Go 官方申请,把几个翻译站点添加到语言列表中。

但实际过程比我最开始预计的复杂得多。

一开始,我先尝试通过邮件联系;邮件没有得到回复之后,才决定改走 GitHub Issue。后面又经历了广告要求、Tour 与其他站内内容的链接边界、问题反馈入口、生产环境改造等一系列问题。

最终,从第一次尝试联系,到 4 门语言正式出现在 go.dev 上,这件事才真正闭环。

这个项目,本来就是从 Go local 开始的

我其实很早就知道 A Tour of Go 有一个 Go local 页面:

https://go.dev/tour/welcome/2

甚至可以说,我最开始决定做这个项目,本身就和这个页面有关。

当时我发现,Go local 里原来的简体中文翻译已经无法正常访问。

也正是因为看到这个缺口,我才开始考虑:

是否可以自己维护一个长期可用、能够持续跟随上游更新的简体中文版本?

后来,这件事逐渐从一个中文翻译项目,扩展成了多语言翻译项目:

https://github.com/shuijingwan/go-tour-i18n

所以,申请进入 Go local 并不是我最近才想到的事情。

从项目一开始,这其实就是一个很自然的长期目标。

一开始,我选择的是发邮件

最初我没有直接创建 GitHub Issue,而是先向 golang-nuts 发邮件。

第一封邮件是在 2026 年 8 月 22 日发送的,主要申请添加简体中文版本。

一周没有收到回复之后,8 月 29 日我又跟进了一次。

那时候德语版本也已经完成,因此第二封邮件里同时补充了德语站点,并询问:

如果第三方语言列表更适合通过代码修改或其他方式提交,希望对方告诉我推荐的流程。

【图 1:两次邮件申请与跟进】
【图 1:两次邮件申请与跟进】

但邮件依然没有得到回复。

这时候我开始觉得,继续等待意义不大。

Go 本身是一个高度依赖 GitHub Issue 和 Gerrit 的开源项目。既然这是一个明确的网站修改需求,那么直接提交 Issue,可能反而才是更合适的方式。

从邮件转向 GitHub Issue

于是,我最终创建了:

golang/go#81336

https://github.com/golang/go/issues/81336

这一次我没有只申请中文。

当时已经具备稳定维护条件的有 4 门语言:

  • Simplified Chinese
  • French
  • German
  • Korean

我的想法其实很简单:

这些翻译都来自同一个仓库、同一套维护流程,并且会持续跟踪上游 A Tour of Go。

如果官方愿意接受,与其每完成一门语言再单独申请一次,不如先把目前已经成熟的几个版本一起提交。

Issue 创建以后,事情终于开始有了进展。

但第一个真正的问题,并不是翻译质量。

而是广告。

第一个意外:Go 官方不接受带广告的 Tour

我的这些站点从一开始就是实际运行的网站。

既然需要服务器、域名、CDN、维护时间,我也接入了 Google AdSense,希望多少补贴一些长期维护成本。

最开始我以为,只要广告不要遮挡教程内容,问题应该不会太大。

当时课程页面主要存在:

  • Auto Ads;
  • 一个课程页手动广告位;
  • 部分自动广告形式。

维护者第一次反馈时,提到的是页面左下角的广告弹出。

于是我先关闭了弹窗、锚定等比较打扰学习体验的广告形式。

我原本以为这样应该就够了。

后来维护者进一步说明,她指的是页面中的 display ads,并明确表示:

As far as I’m aware, the other Go local tours linked from https://go.dev/tour/welcome/2 do not have any display ads. We won’t be able to link to these translations unless they are free of ads.

也就是说,这已经不是:

“不要有侵入式广告。”

而是:

如果要进入 Go local,Tour 本身必须没有广告。

【图 2:维护者明确说明必须 free of ads】
【图 2:维护者明确说明必须 free of ads】

这时候我其实纠结了很久。

为一个官方入口放弃 Tour 广告,值得吗?

这不是一个纯技术问题,而是一个商业上的取舍。

我最早优先翻译 /tour,就是因为我认为 A Tour of Go 是非常高质量的内容。

真正学习 Tour 的用户,经常会连续点击很多课程页面。

从广告角度看,这类页面其实是有价值的。

如果一门语言加入 Go local,就意味着这一门语言的整个 /tour/... 都需要保持无广告。

如果以后有 10 门、20 门语言满足条件并申请官方链接,那相当于越来越多的 Tour 页面放弃直接广告变现。

所以我当时真正考虑的是:

牺牲 Tour 的直接广告收入,换取 Go 官方入口,到底值不值?

后来我还是决定接受这个条件。

原因不是因为广告不重要,而是因为我认为 Go 官方入口本身可能带来另外一种长期价值。

Go 官方入口的价值,不只是一个外链

我从来没有把这些翻译站看成是在和 go.dev 竞争。

go.dev 主要提供英文内容,而我维护的这些站点面向的是不同语言的用户。

两者本身就是互补关系。

如果真要谈竞争,更多也是和同一种语言里的其他第三方翻译、教程站点竞争,而不是和 Go 官方英文站竞争。

所以我真正考虑的是另一件事:

如果用户本来就会先到 Go 官方页面,那么能不能让官方页面直接成为这些社区翻译的入口?

一旦被列入 Go local,访问路径就变成:

go.dev → 对应语言的翻译站

这意味着用户不需要先通过搜索引擎辨别哪个第三方翻译站更可信,而是可以直接从 Go 官方列出的语言入口进入。

这种价值,并不能简单拿 /tour 少赚了多少广告收入来衡量。

它至少可能包括:

  • 官方入口带来的直接流量;
  • Go 官方页面提供的信任背书;
  • 高质量反向链接;
  • 后续可能产生的品牌认知和回访;
  • 对搜索引擎抓取和收录可能产生的长期影响。

所以我最终决定:

对申请 Go local 的语言,Tour 无广告;

其他没有进入 Go local 的语言,继续保持正常商业化能力。

项目内部后来把这两种模式正式区分为:

  • go-local
  • standard

目前 go-local 就是:

  • zh-CN
  • fr-FR
  • de-DE
  • ko-KR

而其他语言仍然是 standard。

这样至少不会因为 4 门语言的官方要求,把整个项目所有语言都永久绑定到同一套商业限制上。

不只是关闭广告,Tour 里的链接也需要调整

广告问题确认之后,又出现了一个更具体的要求。

A Tour of Go 的很多原始页面中存在这样的根相对链接:

  • /doc/...
  • /blog/...
  • /pkg/...
  • /cmd/...
  • /ref/...
  • /talks/...

在 go.dev 上,这些链接本来都会进入 Go 官方内容。

但在我的独立翻译域名中,它们会被浏览器解析成当前站点下的路径。

这其实和我后续的项目规划存在直接关系。

我并不打算只翻译 /tour。

这 4 门语言后续仍然计划继续扩展:

  • /doc
  • /blog
  • 以及其他 Go 相关内容

而且这些非 Tour 内容,我并不打算放弃广告展示。

所以最初我其实希望未来可以形成这样的站内路径:

/tour → 本站 /doc /blog

这样用户学完 Tour 以后,还可以继续留在同一个语言站里阅读更多 Go 内容。

但在沟通中,维护者明确要求:

从 Tour 中直接点击进入的这些内容,同样不能落到带广告的本站页面。

这意味着,如果我以后真的上线本站 /doc、/blog,那么现有 Tour 里的那些根相对链接就会直接进入带广告内容,不再符合 Go local 的要求。

因此,我才把 Tour 中原本属于 Go 官方内容的 /doc、/blog、/pkg、/cmd、/ref、/talks 等链接统一改回对应的:

https://go.dev/…

这并不意味着我会放弃这 4 门语言后续的 /doc、/blog。

相反,我仍然计划继续翻译和扩展这些内容,而且 /doc、/blog 仍然会保留广告展示。

真正发生变化的是入口关系。

我不再让 /tour 里的这些链接直接进入本站未来的商业化内容,而是计划把 /doc、/blog 的入口放在本站首页。

最终形成的路径更像:

Go 官方 → /tour → 本站首页 → /doc /blog

而不是:

Go 官方 → /tour → 直接进入带广告的 /doc /blog

对我来说,这个边界是可以接受的。

虽然牺牲了 Tour 对其他内容的直接导流能力,但并没有放弃整个语言站后续的商业化空间。

还有一个细节:用户发现问题后,应该去哪里反馈?

当广告和链接问题基本解决以后,Go 维护者 Dmitri Shuralyov 又注意到了一个很实际的问题:

这些社区翻译如果出现问题,右上角的 “submit feedback” 应该指向哪里?

最初,我的翻译站仍然沿用了上游配置:

https://go.dev/doc/contribute#check_tracker

但这其实并不合理。

因为用户在我的翻译站里遇到的问题,很可能是:

  • 翻译错误;
  • locale 特有问题;
  • UI 问题;
  • 部署问题;
  • 我的项目自身实现问题。

这些问题直接发给 Go 官方,反而增加上游维护者的负担。

因此我接受了建议,把统一反馈入口改成:

https://github.com/shuijingwan/go-tour-i18n/issues

以后流程就很清楚:

用户先向我的翻译项目反馈。

如果我确认问题来自 Go 上游,再由我整理后向上游提交。

这其实也是我很认可的一种开源维护方式。

既然我希望 Go 官方长期链接这些站点,那么我自然也应该承担对应的第一层维护责任。

法语站还出现了一个缓存小插曲

反馈入口部署完成以后,我分别更新并验证了中文、法语、德语和韩语站。

但维护者测试时发现:

简体中文、德语、韩语都已经正常跳转到新的 GitHub Issues,而法语点击后似乎仍然只是在新标签页打开当前页面。

我重新检查 production:

  • deployment PASS;
  • machine acceptance PASS;
  • browser acceptance PASS;
  • visual HUMAN gate PASS。

我又分别使用正常浏览器和隐私窗口测试法语站。

两边都能够正确打开:

https://github.com/shuijingwan/go-tour-i18n/issues

于是我回复对方:

可能是浏览器仍缓存了旧 JavaScript,可以尝试 hard refresh。

稍后维护者再次确认:

Thanks! It’s working for me now. Will merge the change to add these to the website.

【图 3:法语反馈入口确认正常,维护者表示将 merge】
【图 3:法语反馈入口确认正常,维护者表示将 merge】

到这里,我基本知道这件事已经成功了。

接下来只剩代码合并和官网部署。

CL 829864:4 门翻译正式进入 Go 网站源码

对应修改随后进入 Go Gerrit:

https://go-review.googlesource.com/c/website/+/829864

提交标题很直接:

_content/tour: add translations

最终合并进入 golang/website。

对应 commit:

db076098077c07d3cef1b85a2cf56ff52777f587

Issue #81336 随后被 GopherBot 标记为 completed 并关闭。

这次修改一共加入 4 个链接:

  • French
  • German
  • Korean
  • Simplified Chinese

从这一刻开始,申请本身其实已经正式成功。

但我仍然在等最后一步:

go.dev 生产站真正部署。

2026 年 9 月 11 日:正式上线

到了 2026 年 9 月 11 日,我再次打开:

https://go.dev/tour/welcome/2

这一次,4 门语言已经全部出现在公网生产环境。

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

这张图对我来说,比 commit merged 更有意义。

因为它代表的不只是代码已经进入仓库,而是:

普通 Go 用户已经真的可以从 go.dev 点击进入这些翻译站了。

到这里,从最开始发邮件无人回复,到最后进入官方 Go local,这件事终于完整闭环。

回头看,这次最大的代价其实不是开发时间

如果只看技术改造,这次并不算特别困难。

真正让我反复纠结的,其实还是:

为了官方链接放弃 /tour 广告,到底值不值?

目前还没有答案。

现在刚刚上线,还不可能用一天两天的数据得出结论。

但至少有一件事已经发生变化:

之前这些站点只能依靠:

  • 搜索引擎;
  • GitHub;
  • 我的博客;
  • 直接访问;
  • 其他自然外链。

现在又多了一个非常特别的入口:

go.dev 本身。

而且我一次拥有了 4 个实验样本。

可以把:

  • zh-CN
  • fr-FR
  • de-DE
  • ko-KR

作为 go-local 组;

把:

  • ja-JP
  • es-ES
  • it-IT
  • nl-NL
  • pt-BR
  • 以及未来其他语言

作为 standard 组。

以后就可以真实观察:

  • go.dev referral 能带来多少访问;
  • 是否提高回访率;
  • 是否改善搜索引擎抓取和收录;
  • 是否带来更好的品牌认知;
  • 官方反向链接是否产生 SEO 价值;
  • 这些收益能否抵消 Tour 本身失去的广告收入。

这会比任何理论分析都更有价值。

我打算把 2026 年 9 月 11 日作为 Day 0

后续我准备分别观察:

  • 7 天;
  • 30 天;
  • 90 天。

尤其关注四门 Go local 语言与其他 standard 语言之间的差异。

如果未来发现:

官方链接确实能够持续带来稳定流量,并且明显改善搜索表现、回访和品牌认知,

那么以后遇到 Go local 尚未覆盖、同时具有较高商业潜力的语言,我可能会继续采用:

无广告 Tour ↔ Go 官方入口

这种模式。

反过来,如果几个月之后发现:

官方 referral 很少、SEO 没明显变化、品牌收益也不明显,那么我也会知道:

后续没有必要为了官方链接继续牺牲更多语言的 Tour 广告。

现在还不需要提前下结论。

先让数据自己说话。

接下来:再次同步上游

这次正式上线以后,我还准备马上再做一件事:

重新同步一次 A Tour of Go 上游。

原因也很简单。

现在这 4 个站点已经变成了会被 Go 官方页面直接导流的社区翻译。

既然获得了这个入口,我也希望进入这些站点的用户尽可能看到最新的 A Tour of Go 内容。

后续我仍然会继续维护:

https://github.com/shuijingwan/go-tour-i18n

并逐步增加更多语言。

不过对于已经存在其他官方社区翻译的语言,我不会以替换对方为目标。

新的语言是否继续申请 Go local,也会结合这 4 门语言接下来几个月的真实数据再判断。

上线不到一天,go.dev 已经开始明显导流

官方链接上线以后,我原本以为还需要观察一段时间,才能看出比较明显的流量变化。

但实际效果出现得比我预想得更快。

截至 2026 年 9 月 11 日中午,百度统计已经出现了非常明显的变化。

当天来自 go.dev 的来源 PV 已达到 438,占来源网站 PV 的 64.41%,已经成为当天最主要的来源网站。

从入口页面来看,这些流量也明显进入了 A Tour of Go:

  • /tour:251 PV,占 36.86%
  • /tour/welcome/1:140 PV,占 20.56%
  • 其他具体 Tour 页面也已经出现在主要入口页面中
图 5:截至 2026 年 9 月 11 日中午,go.dev 已经成为当天最主要的来源网站
图 5:截至 2026 年 9 月 11 日中午,go.dev 已经成为当天最主要的来源网站

这组数据对我来说很有意义。

为了进入 Go local,我接受了一个明确的条件:被 Go 官方收录的这 4 门语言,其 Tour 页面不能继续展示广告。

也就是说,我确实放弃了这些 Tour 页面未来直接产生广告收入的可能性,换来了 Go 官方页面提供的入口。

在真正上线以前,我只能判断官方收录可能带来流量和品牌背书,却没有真实数据证明这个入口究竟能带来多少访问。

现在至少其中一个问题已经有了很明确的早期答案:

Go local 并不只是一个用于品牌背书的静态链接,它确实能够带来非常直接,而且相当明显的访问流量。

当然,这只是官方链接上线后不到一天的数据。

一天的数据不能代表未来 30 天,更不能据此判断长期商业价值。Google Analytics 此时的实时统计也已经能够看到访问,但当天的标准「流量获取」报表尚未完成处理,因此这里暂时只采用百度统计已经形成的数据。

接下来我会继续观察 7 天、30 天甚至更长时间的数据,看看来自 go.dev 的流量能够保留多少,以及这些用户是否会进一步访问项目首页、GitHub,以及未来的 /doc、/blog 等内容。

所以现在还不能说,放弃这 4 门语言 Tour 页面的广告收入已经“赚回来了”。

但至少有一件事情已经不需要继续猜测:

go.dev 的官方入口,导流能力确实很强。

写在最后

这次经历给我的一个很直观的感受是:

很多开源项目的“官方收录”,真正考察的并不只是:

你有没有把文字翻译出来。

它还包括:

  • 内容是否长期可访问;
  • 是否持续维护;
  • 页面体验是否合适;
  • 商业化是否符合官方接受范围;
  • 出现问题以后谁负责;
  • 用户应该向哪里反馈;
  • 项目是否具备长期维护能力。

最开始,我只是想申请一个链接。

最后真正做出来的,却是一套专门面向 Go local 的发布策略。

从商业角度看,我也确实付出了代价:

这 4 门语言的 /tour 不再直接展示广告,而且 Tour 里原本可能继续导向本站 /doc、/blog 的入口,也需要和未来的商业化内容做边界隔离。

但换回来的东西同样很明确:

  • Go 官方入口;
  • 来自 go.dev 的高质量反向链接;
  • 社区翻译身份的公开展示;
  • 更低的用户信任成本;
  • 一个可以长期观察官方导流价值的真实实验。

在正式上线之前,我最不确定的一件事其实是:

go.dev 这个入口,究竟能不能真正带来明显流量?

现在,这个问题已经有了一个初步答案。

上线不到一天,go.dev 就已经成为当天最主要的来源网站之一,而且占比非常高。

这还不足以证明长期商业价值,也不能说明放弃 Tour 广告的损失已经被赚回来。

但至少可以确认:

Go 官方入口不是只有“品牌背书”意义,它确实具备很强的直接导流能力。

所以接下来我真正需要观察的,已经不再是“有没有流量”,而是:

  • 这种流量能持续多久;
  • 用户是否会形成回访;
  • 是否会进一步访问首页、GitHub、未来的 /doc、/blog;
  • 是否会改善搜索引擎抓取、收录和自然流量;
  • 最终能否形成足够的长期价值,弥补 Tour 页面停止展示广告的机会成本。

也就是说,这个实验已经从:

官方入口到底有没有用?

进入了下一个阶段:

这个入口长期到底值多少钱?

这个答案,还是需要 7 天、30 天、90 天甚至更长时间的数据才能说明。

但至少从 2026 年 9 月 11 日开始,我已经不用再完全靠猜了。

第一批真实数据,已经开始给出答案。

从 nl-NL 到 tr-TR:A Tour of Go 连续上线三门语言后,我又优化了哪些流程 腾讯云 EdgeOne API 自动化:从 CAM 子用户到最小权限 API Key 的完整配置

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