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

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

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

作者:

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 完成生产发布

从决定为 A Tour of Go 多语言翻译项目增加第二门语言开始,到今天正式上线,日语版前后已经经历了多轮翻译流程调整、自动化改进和翻译质量实验。

前面的文章已经记录过为什么选择日语、ChatGPT 与 Codex 的协作方式、翻译自动化流程的问题,以及最终为什么将正式 TranslationUnit 翻译引擎调整为 Codex GPT-5.6 Sol High。

因此这一篇不再重复前面的选择和实验过程,只记录一个阶段性结果:

2026 年 8 月 24 日,A Tour of Go ja-JP 第一版正式完成生产上线。

日语版正式地址:

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

从第二门语言开始,项目才真正进入多语言阶段

在开始 ja-JP 之前,项目已经有完整的简体中文版本,也已经建立了 locale、TranslationUnit、automatic validation、Quality Check、Final Review、promotion、projection 和 publish 等基础能力。

但只有一门社区语言的时候,这些设计究竟是不是能够真正扩展到第二门语言,其实还没有得到完整验证。

从开始增加日语以后,我也连续写了几篇相关记录。

图 1:从选择日语到翻译质量实验,已经连续记录了多轮 ja-JP 实践
图 1:从选择日语到翻译质量实验,已经连续记录了多轮 ja-JP 实践

这几轮工作的重点已经逐渐从“能不能翻译”变化为:

  • 如何让一整个 TranslationUnit 在不破坏 present、代码和链接结构的情况下完成翻译;
  • 如何减少人工复制粘贴;
  • 如何区分工程失败和语言质量问题;
  • 如何让 automatic validation 与语言质量审核各自承担清晰的职责;
  • ChatGPT 与 Codex 在正式翻译中的职责如何划分;
  • 选择什么模型作为长期默认生产翻译引擎。

最终,当前正式 TranslationUnit 翻译方案已经确定为:

Codex GPT-5.6 Sol High

而 ChatGPT 主要承担统一的 Quality Check 和后续语言质量审核。

ja-JP 正式生产站完成上线

这一次日语版不是单独复制一个页面或者做一个静态演示,而是按照项目现有架构构建了独立的 ja-JP 生产站。

图 2:A Tour of Go ja-JP 正式生产首页
图 2:A Tour of Go ja-JP 正式生产首页

当前首页已经能够根据 locale 使用对应的日语 UI,包括项目介绍、当前语言、课程入口、项目状态以及语言版本等内容。

生产域名采用:

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

简体中文站继续使用:

https://go-dev.shuijingwanwq.com

当前采用的是“一个语言,一个独立站点”的构建和部署方式,而不是让多个 locale 在同一个运行实例中动态切换。

这样不同语言可以分别维护、构建、部署和使用 CDN,同时服务端核心代码仍然尽量共享。

103 个课程页面已经完整进入日语版本

课程目录也已经完成了 ja-JP 本地化。

图 3:ja-JP 的 /tour/list 课程目录
图 3:ja-JP 的 /tour/list 课程目录

从图中可以看到,包括基础、流程控制、方法与接口等课程结构已经完整呈现为日语版本。

这里的课程页面并不是简单把几个标题翻译一下。

项目中的 Page TranslationUnit 仍然以一个完整的顶层 present.Section 作为最小翻译单位。

也就是说,一个页面必须作为完整上下文一起翻译,并且需要保留:

  • present 结构;
  • Go 代码;
  • Go 标识符;
  • 链接 target;
  • URL 和路径;
  • directive;
  • protected token;
  • 其他不可翻译的机器语义内容。

TranslationUnit 不会被拆成若干句子分别处理。

不只是静态页面,Playground 也能够正常使用

A Tour of Go 的一个重要特点就是可以直接在浏览器里修改和运行 Go 示例。

因此,只完成页面翻译还不能算真正完成上线。

日语生产站还需要保证编辑器、执行按钮、格式化、运行结果以及 Playground 代理全部能够正常工作。

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

图中可以看到,课程正文已经是日语,编辑器相关 UI 也已经本地化,例如:

  • 実行
  • フォーマット
  • リセット

实际点击运行后,可以正常得到:

Plaintext
Hello, 世界

并显示日语运行状态:

Plaintext
プログラムが終了しました。

这一步也验证了浏览器到 Playground 代理之间的完整生产链路。

日语站上线时还专门增加了 ja-JP production Origin 的 CORS 支持,否则页面虽然可以正常打开,Run 和 Format 仍然会失败。

所以这一轮最终验收并不只是“网页 HTTP 200”,还包括真实浏览器中的实际运行。

122 个 TranslationUnit 全部进入正式状态

ja-JP 当前完整翻译集合一共包含:

  • 103 个 Page;
  • 19 个 eligible Example;
  • 合计 122 个 TranslationUnit。

本地最终状态检查结果如下。

图 5:ja-JP 122 个 TranslationUnit 状态检查通过
图 5:ja-JP 122 个 TranslationUnit 状态检查通过

正式输出为:

Plaintext
status OK: 122 translation units for ja-JP (103 pages, 19 examples)

这些 TranslationUnit 并不是模型生成译文以后就直接发布。

当前正式生产链路大致是:

Plaintext
retranslation export

Codex GPT-5.6 Sol High

raw-responses

retranslation process

automatic validation

Candidate Snapshot

ChatGPT Quality Check

Final Review

promotion

ready

projection / publish

automatic validation 主要负责可以由机器严格验证的安全性,例如 protected token、present 结构、代码、链接 target、directive、source identity、candidate identity 和 render 等。

但 automatic validation 通过并不代表译文语言质量已经达到正式发布标准。

所以每一个 TranslationUnit 之后仍然需要独立进行语言质量审核。

当前生产门槛是严格的 A-only

Quality Check 中,只要出现 B、C 或 D,都不能直接进入最终发布,而必须创建新的 revision batch,重新翻译,再重新经过 validation 和 Quality Check。

Final Review 同样要求最终 TranslationUnit 达到 A。

ja-JP 最终完成的是全部 122 个 TranslationUnit 的正式审核和 promotion。

非中文语言开始共享生产基础设施

ja-JP 也是项目第一次真正验证第二门语言的独立生产部署。

简体中文目前继续使用 EdgeOne。

ja-JP 则采用 Cloudflare Free。

同时,为了避免每增加一种语言都重复发布完全相同的 CSS、图片和部分公共资源,还建立了非中文站点共享静态资源域名:

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

当前只共享经过明确 allowlist 管理的静态资源。

而像 /tour/script.js 这种包含 locale 相关运行时信息的动态内容,并没有为了“共享”而强行拆分。

这个边界在实际部署第二门语言以后变得更加清楚:

能安全共享的资源共享,和 locale、运行时行为有关的资源继续由各语言站点自己生成。

sitemap 共包含 105 个公开 URL

生产部署完成以后,还对 ja-JP 的 SEO 输出进行了完整检查。

这里曾经发现过一个很典型的问题:

日语站虽然已经正常运行,但 sitemap 最初仍然使用了简体中文站的 hostname。

后来将 SEO origin 正式改为从 locale 的语言 registry 中获取,而不是使用固定的 zh-CN hostname。

修复以后,ja-JP 的:

  • robots.txt
  • sitemap
  • canonical host
  • html lang

都能够根据当前 locale 正确生成。

当前 ja-JP sitemap 共包含 105 个公开 URL

这里的 105 与前面的 122 并不是同一个概念:

Plaintext
122
= TranslationUnit 数量
= 103 Page + 19 Example

105
= sitemap 中对外公开的 URL 数量

Example TranslationUnit 并不会简单对应一个新的独立公开页面,因此两个数字并不需要相同。

Google Search Console 已经成功读取 sitemap

上线以后,我也将 ja-JP 独立添加到了 Google Search Console。

图 6:Google Search Console 已成功处理 ja-JP sitemap,并发现 105 个网页
图 6:Google Search Console 已成功处理 ja-JP sitemap,并发现 105 个网页

当前结果为:

Plaintext
站点地图:/sitemap.xml
状态:已成功处理站点地图
已发现的网页:105

这与生产环境自己的 sitemap 验收结果一致。

Bing Webmaster Tools 中也已经提交 ja-JP sitemap,目前让搜索引擎自行抓取即可。

这一次没有继续使用 IndexNow。之前已经做过相关测试,短期效果并不明显,所以没有必要为了主动推送继续增加维护工作。

从“中文翻译项目”变成真正经过验证的多语言项目

我觉得 ja-JP 上线最重要的意义,其实并不只是“多了一个日语网站”。

zh-CN 完成以后,项目已经在代码层面为多语言做了很多准备。

但只有第一门语言时,很难判断哪些设计是真正可复用的,哪些只是因为第一门语言恰好能够工作。

ja-JP 完整走完以后,很多问题才真正暴露出来。

比如:

  • 新语言首次生产部署仍然需要重新确认不少服务器环境;
  • OneinStack 自动生成的 Nginx 配置可能带入不适合当前应用的静态 location;
  • Cloudflare Universal SSL 会直接影响子域名层级设计;
  • sitemap hostname 不能继续假定只有 zh-CN;
  • Playground 的 CORS Origin 必须随着语言站点扩展;
  • TranslationUnit 的语言质量审核已经很严格,但首页、公共 UI、/tour/list、runtime message 等内容以前没有同等级的独立审核阶段;
  • glossary 中虽然已经存在正式术语决定,但以前并没有明确要求这些决定覆盖整个 locale 的公共 UI。

这些问题很多只有真的添加第二门语言以后才会出现。

因此我现在更愿意把 ja-JP 看成一次完整的多语言架构验证,而不只是一次翻译任务。

第一版上线以后,先不急着开始第三门语言

ja-JP 正式上线以后,我没有立即开始第三门语言。

因为第二门语言已经暴露出一个新的问题:

虽然现在已经知道怎样把一门语言做出来,但“新增下一门语言”的过程仍然过度依赖临时分析和此前的上下文。

于是上线以后,我又专门整理了一轮项目文档,并正式增加:

Plaintext
docs/NEW_LOCALE_RUNBOOK.md
docs/LOCALE_SURFACE_REVIEW.md

开始把“新增一门语言”本身变成一条正式流程。

其中也新增了 TranslationUnit 之外的 Locale Surface Review,用来覆盖:

  • 公共 UI;
  • 首页;
  • /tour/
  • /tour/list
  • 导航;
  • 语言选择器;
  • 编辑器;
  • runtime message;
  • article metadata;
  • SEO;
  • 桌面端和移动端实际页面。

这一部分值得单独整理,因此准备放到下一篇继续记录。

如果说这一篇记录的是:

ja-JP 最终做成了什么。

那么下一篇更想记录的是:

做完 ja-JP 以后,怎样让第三门语言不需要重新踩一遍这些坑。

小结

2026 年 8 月 24 日,A Tour of Go ja-JP 第一版正式完成上线。

当前这一版已经完成:

  • 103 个课程 Page;
  • 19 个 eligible Example;
  • 122 个 TranslationUnit;
  • 全量 automatic validation;
  • 全量 TranslationUnit Quality Check;
  • Final Review;
  • promotion;
  • ja-JP 公共 UI;
  • 日语首页和课程目录;
  • 独立生产部署;
  • Cloudflare Free;
  • 非中文共享静态资源;
  • HTTPS;
  • locale-specific SEO;
  • 105 个 sitemap URL;
  • robots.txt
  • Playground Run / Format;
  • 真实浏览器运行验收;
  • Google Search Console sitemap 提交。

从这一刻开始,go-tour-i18n 不再只是一个已经为“未来多语言”做好代码准备的中文翻译项目。

第二门社区语言已经真正运行在生产环境中。

而接下来的重点,也会逐渐从“如何完成第二门语言”,转向另一个更长期的问题:

如何让新增第三门、第四门以及更多语言,变成一件能够按照规范重复执行的事情。

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

A Tour of Go 多语言翻译项目

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

项目入口:
✅ 在线学习:A Tour of Go 简体中文版
✅ 项目源码:GitHub:shuijingwan/go-tour-i18n

当前第一阶段已完成简体中文版本。项目属于非官方社区多语言翻译项目,与 Go 官方无隶属或授权关系。