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

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

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

作者:

在

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

【图8:Google AI 概览——引用网站的课程目录页】

(96) 同一个 Go 语言之旅网站,Bing、Google 和百度的搜索表现差距有多大?

多个正式命令原本分别重复构建当前内容成员、历史审核链、回执、SHA 和身份标识等可信环境;优化后改为先建立一次已验证的执行环境,再由 current-check、result-pack、import 等连续命令安全复用。

(97) 一个命令快了还不够:为什么我的性能优化开始转向跨命令环境复用

learn-docs-v1 原本以 49 个页面完成了翻译、审核和最终确认,后来发现还缺少 /doc/ 与 /doc/install 两个页面,导致内容包必须从 49 Page 迁移到 51 Page。图片对比了“后期补齐造成迁移成本”和“在 Generation 前先完成成员完整性审计”两种方式。

(98) 只是多了 2 个页面,为什么却触发了一次 49→51 的迁移?

【图2:维护者在 GitHub Issue #1 中回复,说明 math.pi 是官方课程有意设计的教学示例】

(99) 开源项目收到第一个 Issue:为什么我最终选择不修改代码?

一个翻译项目,为什么最后花了大部分时间证明基础设施?

(100) 一个翻译项目,为什么最后花了大部分时间证明基础设施?

【图2:GitHub Secret Scanning 显示 Google API Key 告警】

(101) GitHub 提示 Google API Key 泄露:为什么我最终选择了 Won’t fix?

A Tour of Go 简体中文站正式上线到:

Plaintext
https://go-dev.shuijingwanwq.com/

之后,我开始处理上线后的搜索引擎提交。

这次原本的计划很简单:沿用此前给 en.shuijingwanwq.com 添加搜索引擎资源时积累的经验,快速完成 Google、Bing、360、百度和搜狗五个平台的接入。

实际操作下来,搜索引擎提交本身并不复杂,但在正式提交之前,我先发现了两个更基础的问题:

  • /robots.txt 实际返回的是 Tour 首页 HTML;
  • /sitemap.xml 同样返回 Tour 首页 HTML。

也就是说,A Tour of Go 应用的通配路由接管了这两个本应提供给搜索引擎的路径。

最终这次工作不只是完成了五个平台提交,还顺手补齐了生产站的 SEO 基础入口,解决了百度和搜狗的验证文件访问问题,并清理了 Nginx 新版本下已经过时的配置警告。


一、正式提交前,先检查搜索引擎抓取入口

最开始,我从公网检查:

Plaintext
https://go-dev.shuijingwanwq.com/robots.txt
https://go-dev.shuijingwanwq.com/sitemap.xml

结果发现,两者虽然都返回 HTTP 200,但 Content-Type 都是:

Plaintext
text/html; charset=utf-8

正文也不是 robots 或 Sitemap,而是完整的“Go 语言之旅”首页 HTML。

根因很直接:

生产 HTTP 路由没有注册 /robots.txt 和 /sitemap.xml,因此请求最终落到了 Tour 的 / 通配路由。

所以我没有急着进入各个站长平台,而是先暂停搜索引擎提交,在 go-tour-i18n 中补齐这两个入口。


二、从正式课程页面集合动态生成 Sitemap

这次没有另外维护一份 103 页的硬编码 Sitemap 列表。

项目本身已经掌握完整的正式课程页面集合,因此 Sitemap 直接从正式渲染页面生成。

最终包含:

  • 首页:1 个;
  • 正式课程页面:103 个;
  • 总计:104 个 URL。

课程 URL 统一采用:

Plaintext
https://go-dev.shuijingwanwq.com/tour/{article}/{section}

同时没有人为加入没有可靠来源的数据:

  • lastmod
  • changefreq
  • priority

也没有出现已经废弃的旧域名:

Plaintext
go-tour.shuijingwanwq.com

robots.txt 则保持得很简单:

Plaintext
User-agent: *
Allow: /

Sitemap: https://go-dev.shuijingwanwq.com/sitemap.xml

相关代码测试完成后提交:

Plaintext
7162b98 feat: 添加搜索引擎抓取入口

随后重新生成生产发布包。


三、生产发布前,再验证一次真实 bundle

新的 production bundle 仍然保持:

Plaintext
locale=zh-CN
ready=103
pending=0
blocked=0
pages=103
articles=7

为了避免“源码测试正常、实际发布包却有差异”的情况,我直接启动最终 production bundle 做本地验收。

最终确认:

Plaintext
/robots.txt
HTTP 200
Content-Type: text/plain; charset=utf-8

/sitemap.xml
HTTP 200
Content-Type: application/xml; charset=utf-8

Sitemap URL 数量
104

课程页面本身也继续正常:

Plaintext
/tour/welcome/1
HTTP 200
<html lang="zh-CN">
<title>Go 语言之旅</title>

而 /tour/lesson/ 仍然能够返回中文课程数据。

这说明新增 SEO 入口没有影响现有 Tour 的工作方式。


四、部署生产并处理 EdgeOne 旧缓存

新的 production bundle 上传服务器后,先完成:

  • SHA-256 完整校验;
  • go-tour 服务用户读取权限检查;
  • release 目录检查;
  • current 切换前后确认。

之后再原子切换:

Plaintext
/data/go-tour/current

从旧版本:

Plaintext
/data/go-tour/releases/20260812-zh-CN-cac4d6e

切换到:

Plaintext
/data/go-tour/releases/20260812-zh-CN-7162b98

服务重启后:

Plaintext
go-tour.service
Active: active (running)

源站直接访问已经能够正确获得新的 robots 和 Sitemap。

不过公网访问一开始仍然拿到了旧内容。

原因不是应用,也不是 Nginx,而是 EdgeOne 节点仍然保留着部署前的缓存。

因此我只精准清除了:

Plaintext
https://go-dev.shuijingwanwq.com/robots.txt
https://go-dev.shuijingwanwq.com/sitemap.xml

没有刷新整个站点。

刷新后公网重新回源,最终得到:

Plaintext
robots.txt
HTTP/2 200
content-type: text/plain; charset=utf-8

sitemap.xml
HTTP/2 200
content-type: application/xml; charset=utf-8

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

五、曾经短暂考虑:课程正文不在源代码里,会不会影响 SEO?

这里还有一个比较值得记录的小插曲。

在浏览器打开:

Plaintext
view-source:https://go-dev.shuijingwanwq.com/tour/welcome/1

时,我发现原始 HTML 中并没有当前课程正文。

页面源码中主要还是 Tour 的 HTML 外壳,课程正文是在 JavaScript 运行以后,再通过课程接口获取并渲染出来的。

这让我一度产生了一个疑问:

如果搜索引擎拿到的初始 HTML 中没有课程正文,那么给 103 个课程页面生成 Sitemap 到底还有多大意义?

于是又专门检查了官方 A Tour of Go 当前的实现。

结果发现官方本身仍然采用类似的客户端渲染结构:

HTML
<div table-of-contents></div>

<div ng-view ng-cloak class="ng-cloak"></div>

<script src="/tour/script.js"></script>

具体课程数据同样是在浏览器运行 JavaScript 后获取。

也就是说:

这不是简体中文翻译项目引入的新问题,而是官方 A Tour of Go 本身的架构方式。

因此最终没有为了 SEO 单独把整个 Tour 改造成服务器端渲染。

对于 A Tour of Go 这种连续教程型网站,我现阶段更看重:

  • 首页能够正常抓取和建立索引;
  • 搜索引擎能够发现整个课程 URL 集合;
  • 用户从首页进入后,通过 Tour 自身的课程导航继续学习。

课程页能够获得独立索引当然更好,但目前没有必要为了这个目标大幅偏离官方架构。


六、Google Search Console:104 个页面全部发现

SEO 基础入口准备完成以后,正式开始搜索引擎提交。

第一个是 Google Search Console。

go-dev 此前已经作为独立 URL 前缀资源存在,所以直接进入“站点地图”,提交:

Plaintext
sitemap.xml

Google 很快完成读取:

Plaintext
状态:成功
已发现的网页:104

这也反向证明,新生成的 Sitemap 不只是能够访问,而且能够被 Google 正常解析。

图 2:Google Search Console 成功读取 go-dev Sitemap,并发现 104 个网页。
图 2:Google Search Console 成功读取 go-dev Sitemap,并发现 104 个网页。

七、Bing:继续沿用之前添加 en 子域的经验

接下来是 Bing Webmaster Tools。

这里没有重新添加 go-dev 独立站点。

之前处理 en.shuijingwanwq.com 时已经验证过一种更简单的方式:

直接在现有 shuijingwanwq.com Bing 资源下面提交子域的完整 Sitemap 地址。

所以这次继续沿用:

Plaintext
https://go-dev.shuijingwanwq.com/sitemap.xml

很快显示:

Plaintext
状态:成功
已发现 URL:104
图 3:Bing Webmaster Tools 成功读取 go-dev Sitemap,并发现 104 个 URL。
图 3:Bing Webmaster Tools 成功读取 go-dev Sitemap,并发现 104 个 URL。

这次也再次说明了一个很实际的经验:

已经走通过一次的平台流程,没有必要换一个子域以后再重新探索一遍。

能直接复用此前的成功经验,就尽量不要重复踩坑。


八、360:添加二级站,再设置 HTTPS 和 Sitemap

360 这边同样沿用此前处理 en 时的经验。

因为 go-dev.shuijingwanwq.com 是已有主域下面的子域,因此没有重新选择“添加网站”,而是:

Plaintext
站点管理
→ 添加二级站

添加:

Plaintext
go-dev.shuijingwanwq.com

添加成功后,站点显示:

Plaintext
备案状态:已备案
站点权限:拥有者

随后完成 HTTPS 设置,再进入:

Plaintext
数据提交
→ Sitemap提交

提交:

Plaintext
https://go-dev.shuijingwanwq.com/sitemap.xml
图 4:360 站长平台完成 go-dev 二级站、HTTPS 与 Sitemap 提交。
图 4:360 站长平台完成 go-dev 二级站、HTTPS 与 Sitemap 提交。

刚提交时,“包含 URL”和“更新时间”暂时显示 --,这个阶段没有必要一直等待。

Sitemap 已经成功进入平台即可。


九、百度:继续采用文件验证,但不修改 Tour 应用

百度搜索资源平台需要单独添加:

Plaintext
https://go-dev.shuijingwanwq.com

站点属性继续选择“信息技术”。

到了验证阶段,百度提供:

  • 文件验证;
  • HTML 标签验证。

之前处理 en 时已经使用过文件验证,因此这次继续沿用。

百度生成的验证文件类似:

Plaintext
baidu_verify_codeva-XXXXXXXXXX.html

但 go-dev 与 WordPress 站点不同。

它本身是一个 Go Tour 应用,并没有一个传统意义上可以随便往根目录丢 HTML 文件的 Web 根目录。

一开始可以考虑把这个验证路径增加到 Tour 应用中,但很快发现其实完全没有必要。

因为生产环境前面本来就有 Nginx:

Plaintext
EdgeOne
→ Nginx
→ 127.0.0.1:3999
→ Tour

因此最终把验证文件长期保存到:

Plaintext
/data/go-tour/verification/

然后通过 Nginx 精确匹配:

Nginx
location = /baidu_verify_codeva-XXXXXXXXXX.html {
    alias /data/go-tour/verification/baidu_verify_codeva-XXXXXXXXXX.html;
    default_type text/html;
}

这样只有百度验证文件由 Nginx 直接返回:

Plaintext
/baidu_verify_codeva-XXXXXXXXXX.html

其他所有 Tour 请求仍然继续:

Plaintext
proxy_pass http://127.0.0.1:3999;

完全不需要污染 Tour 应用本身。


十、顺便清理 Nginx 新版本下的旧配置警告

修改百度验证配置以后执行:

Bash
nginx -t

发现已有 Nginx 配置存在两个历史警告。

第一个是旧 HTTP/2 写法:

Nginx
listen 443 ssl http2;
listen [::]:443 ssl http2;

于是调整为:

Nginx
listen 443 ssl;
listen [::]:443 ssl;
http2 on;

第二个是:

Nginx
ssl_stapling on;
ssl_stapling_verify on;

当前证书已经没有可供 Nginx 使用的 OCSP responder,因此对应配置只会不断产生:

Plaintext
ssl_stapling ignored

的警告。

这两行也一并删除。

最终重新执行:

Bash
nginx -t

只剩:

Plaintext
nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /usr/local/nginx/conf/nginx.conf test is successful

不再有原来的警告。

然后按照当前生产运维手册使用:

Bash
service nginx reload

完成重载。


十一、百度验证成功,还顺手发现 en 漏了“关联主体”

百度验证文件通过源站和 EdgeOne 两层访问测试后,完成网站验证。

最终在百度“站点管理”中已经可以同时看到:

Plaintext
https://go-dev.shuijingwanwq.com/
https://en.shuijingwanwq.com/
https://www.shuijingwanwq.com/
图 5:百度搜索资源平台完成 go-dev 站点验证,同时补齐现有站点的主体关联。
图 5:百度搜索资源平台完成 go-dev 站点验证,同时补齐现有站点的主体关联。

这里还顺手发现了一个之前遗漏的问题:

en.shuijingwanwq.com 虽然早已经添加到百度,但此前没有关联现有主体。

后来查看 en 的百度索引量,发现即使没有关联主体,百度实际上仍然一直在建立索引,最近索引量甚至已经增长到 80 多。

所以:

没有关联主体,并不意味着百度完全不会收录站点。

不过既然已经发现这个遗漏,而且 www、en、go-dev 本身都属于同一主体,这次就顺手把三个站点的主体关联统一补齐。


十二、搜狗:这次文件验证终于一次成功

最后一个平台是搜狗资源平台。

此前给 en.shuijingwanwq.com 做搜狗验证时,文件验证曾经反复失败。

当时 en 使用 Cloudflare CDN,我一直怀疑搜狗的验证抓取与 Cloudflare 之间存在某种兼容问题,但始终没有足够证据确认。

这一次 go-dev 使用的是 EdgeOne,所以正好再测试一次。

搜狗生成的验证文件为:

Plaintext
sogousiteverification.txt

同样没有修改 Tour 应用,而是放到:

Plaintext
/data/go-tour/verification/sogousiteverification.txt

再通过 Nginx 精确匹配:

Nginx
location = /sogousiteverification.txt {
    alias /data/go-tour/verification/sogousiteverification.txt;
    default_type text/plain;
}

分别验证:

Plaintext
源站 Nginx
→ HTTP 200

EdgeOne 公网
→ HTTP 200
→ EO-Cache-Status: MISS

验证文件内容也完全正确。

随后回到搜狗点击“完成验证”。

这一次:

一次成功。

这至少说明当前:

Plaintext
EdgeOne
→ Nginx
→ 验证文件

这条链路能够被搜狗正常访问。

至于之前 en + Cloudflare 验证失败是否真的由 Cloudflare 引起,目前还不能仅凭这一次对照直接下定论,但这个差异值得保留记录。


十三、搜狗不需要走完整资质审核,也已经能提交资源

搜狗完成网站验证以后,平台继续引导进入:

Plaintext
提交资质
→ 审核资质

需要填写:

  • 网站名称;
  • 行业;
  • ICP 备案号;
  • ICP 备案截图;
  • 主办方;
  • 主体信息;
  • 运营者信息。

一开始我不确定:

如果不把这整套资质流程做完,会不会影响搜狗收录?

于是没有急着继续填写,而是先进入:

Plaintext
搜索服务
→ 资源收录

结果在站点下拉框里已经能够直接选择:

Plaintext
go-dev.shuijingwanwq.com

也就是说:

网站验证完成以后,即使没有继续提交完整资质,也已经能够以“已验证站点”的身份使用基础资源收录功能。

因此目前没有必要为了搜索引擎收录继续填完整资质。


十四、搜狗 Sitemap 仍然采用邀请制

搜狗“资源收录”页面同时存在:

Plaintext
URL提交
Sitemap提交

于是又检查了一下 Sitemap 权限。

结果页面明确显示:

Plaintext
此站点未开通 sitemap 权限

并说明 Sitemap 属于邀请制,需要搜狗 Spider 对站点抓取达到一定条件以后才可能开放。

图 6:搜狗已完成 go-dev 网站验证并开放基础资源收录,但 Sitemap 提交权限仍采用邀请制。
图 6:搜狗已完成 go-dev 网站验证并开放基础资源收录,但 Sitemap 提交权限仍采用邀请制。

这也意味着目前五个平台的实际情况并不完全一致。


十五、五个平台最终状态

至此,go-dev.shuijingwanwq.com 的搜索引擎接入状态如下:

Google

Plaintext
✅ 独立资源
✅ Sitemap 提交成功
✅ 已发现 104 个网页

Bing

Plaintext
✅ 在现有 shuijingwanwq.com 资源下提交
✅ Sitemap 成功
✅ 已发现 104 个 URL

360

Plaintext
✅ 添加二级站
✅ HTTPS
✅ Sitemap 已提交

百度

Plaintext
✅ 添加 go-dev 站点
✅ 文件验证通过
✅ 关联现有主体
⚠ 当前账号/站点没有直接使用 Sitemap 提交的条件

搜狗

Plaintext
✅ 网站文件验证通过
✅ 可以作为已验证站点使用资源收录
⚠ Sitemap 权限仍为邀请制

十六、为什么我开始考虑单独做一个“搜索引擎提交项目”

做到最后,一个新的需求也变得越来越明显。

目前我已经维护:

Plaintext
www.shuijingwanwq.com
en.shuijingwanwq.com
go-dev.shuijingwanwq.com

以后 A Tour of Go 如果继续增加新的语言,还可能出现更多站点。

如果每一次新站上线、新文章发布,都手工进入:

Plaintext
Google
Bing
360
百度
搜狗

逐个平台操作,会产生越来越多重复劳动。

而且各个平台支持的能力并不一样:

Plaintext
Google / Bing / 360
→ Sitemap 相对方便

百度
→ 更适合结合主动推送接口

搜狗
→ Sitemap 邀请制
→ 当前可以使用 URL 提交

所以后续我比较倾向于单独做一个很轻量的项目,例如:

Plaintext
search-engine-submit

职责保持简单:

Plaintext
读取 sitemap.xml / URL 列表
        ↓
识别新增或需要重新提交的 URL
        ↓
调用能够自动提交的官方接口
        ↓
生成需要人工提交的平台 URL 清单
        ↓
保存每次提交状态

第一阶段完全没有必要做:

  • 数据库;
  • Web 管理后台;
  • 分布式任务队列;
  • 复杂调度系统。

一个命令行工具加少量 JSON 状态文件,就已经足够解决主要重复劳动。


十七、这次最大的体会:已经验证过的经验,要直接复用

这次实际操作时间并不算长,一个很重要的原因就是大量复用了之前添加 en.shuijingwanwq.com 时积累的经验。

例如:

Bing 不再重新探索“如何添加一个独立子域站点”,而是直接:

Plaintext
现有 shuijingwanwq.com
→ Sitemap
→ 提交 go-dev 完整 Sitemap 地址

360 直接:

Plaintext
添加二级站
→ HTTPS
→ Sitemap

百度继续:

Plaintext
添加网站
→ 文件验证

搜狗同样优先尝试:

Plaintext
文件验证

差别只在于,这次 go-dev 是独立 Go 应用,所以把验证文件统一放在:

Plaintext
/data/go-tour/verification/

再交给 Nginx 精确处理。

整个过程没有必要为了两个搜索引擎验证文件修改 Tour 应用。

这种做法也让我越来越确认:

对长期维护的项目来说,记录以前已经验证成功的生产经验很重要。下一次遇到同类问题时,真正提高效率的往往不是重新寻找“更聪明”的方案,而是直接复用已经走通过的路径。


十八、当前结果

经过这一轮处理,A Tour of Go 简体中文站上线后的搜索引擎基础工作已经完成。

现在生产环境已经拥有:

Plaintext
https://go-dev.shuijingwanwq.com/robots.txt
https://go-dev.shuijingwanwq.com/sitemap.xml

Sitemap 中:

Plaintext
首页:1
课程页:103
总 URL:104

并且:

Plaintext
Google  ✅
Bing    ✅
360     ✅
百度    ✅
搜狗    ✅

五个平台都已经完成当前阶段能够完成的接入。

下一步不需要继续频繁调整。

先让搜索引擎自然抓取、建立索引,再根据实际数据观察:

  • 首页是否进入索引;
  • 搜索品牌词和 Go 教程相关关键词时是否开始出现;
  • 103 个课程页面能有多少被独立发现;
  • 百度、360、搜狗对这种 JavaScript Tour 页面的抓取效果如何;
  • 是否值得启动独立的搜索引擎 API 提交工具项目。

A Tour of Go 简体中文站已经从“能够正式访问”,继续向“能够被搜索引擎稳定发现”迈进了一步。

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