系列： A Tour of Go 多语言翻译项目
A Tour of Go 多语言翻译项目
本系列完整记录 A Tour of Go 多语言翻译项目从架构设计、整页翻译、结构保护、自动校验，到生产发布与后续维护的实际开发过程。
项目入口：
✅ 简体中文：A Tour of Go 简体中文版
✅ 日语：A Tour of Go 日语版
✅ 德语：A Tour of Go 德语版
✅ 法语：A Tour of Go 法语版
✅ 项目源码：GitHub：shuijingwan/go-tour-i18n
当前已上线简体中文、日语、德语和法语版本。项目属于非官方社区多语言翻译项目，与 Go 官方无隶属或授权关系。
-
在 A Tour of Go 多语言翻译项目中，最初版本主要完成左侧课程正文的简体中文翻译，但右侧 Playground 示例代码仍然保留英文注释。 对于编程教程而言，课程正文和代码示例是一个完整学习单元。如果代码注释仍然是英文，即使代码可以正常运行，整体学习体验仍然不完整。 本次更新将 Playground Example 纳入统一翻译体系，作为独立 TranslationUnit 管理。项目通过 Go scanner 识别真实注释，只开放普通自然语言注释参与翻译，同时保护代码、字符串、布局以及机器语义内容，确保翻译后仍然保持合法 Go source。 最终，右侧 Playground 示例代码注释也完成中文本地化，实现从课程正文到代码示例的完整学习体验。
-
在 A Tour of Go 多语言翻译项目中，广告接入没有直接将 AdSense 代码写入公开源码，而是沿用已有的生产配置注入机制，实现从 AdSense 专用配置到通用 HTML 注入架构的重构。 本次调整新增独立 TOUR_AD_HTML 注入链路，将广告内容通过 systemd 环境变量提供，由 Go 服务读取并渲染到 HTML 。公开源码和发布包只保留注入位置，不包含具体广告平台配置。 通过这一设计，项目实现了广告逻辑与具体平台解耦，同时保持源码公开、生产配置独立的架构，为未来更换广告平台或扩展其他 HTML 注入场景提供基础。
-
记录 go-dev.shuijingwanwq.com 单页网站接入统计与 Google AdSense Auto Ads 的验证过程。由于 A Tour of Go 采用 SPA 架构，页面切换不会触发传统页面刷新，因此需要验证第三方统计和广告服务对动态路由变化的支持情况。经过测试，Google Analytics 4 与百度统计均能够正常记录课程页面切换，Google AdSense Auto Ads 也完成脚本加载、隐私流程以及自动广告展示验证。目前页面内广告仍处于持续观察阶段，后续将根据实际展示效果进一步优化广告策略。
-
A Tour of Go 多语言翻译项目完成简体中文版本后，开始进入第二语言扩展阶段。本文记录选择日语（ja-JP）作为第二语言的原因，以及首批日语翻译任务、batch 管理、raw response 和自动 validation 流程验证过程。
-
Post Views: 10 项目当前流程 当前日语翻译任务采用： 项目已经明确： 相关规则已经记录在项目文档中。 Git 提交记录出现变化 在日语翻译初期： chatgpt-ja-JP-001 提交信 […]
-
在 go-tour-i18n 多语言翻译项目中，最初计划让 ChatGPT 完成翻译后直接写入 GitHub 仓库。实际验证后发现，当前会话环境中的 GitHub 写入、commit、push 流程不适合作为稳定依赖。因此项目调整为：ChatGPT 负责读取 GitHub 输入并生成 raw-responses artifact，本地环境通过新增的 retranslation import 命令完成导入、process、validation、review 和 Git 操作。本文记录这次翻译交付流程调整，以及 AI 与工程环境职责重新划分的实践经验。
-
在 go-tour-i18n 多语言翻译项目推进过程中，我曾经通过 ChatGPT + GitHub batch 完成 A Tour of Go 简体中文 103 页全量重译验证。后续扩展 ja-JP 翻译时，继续沿用了基于 TranslationUnit 的翻译流程，并尝试从 GitHub 写入调整为 raw-responses artifact 导入模式。实际测试发现，ChatGPT 能够理解项目流程、读取 batch 和 manifest，但在新任务中无法稳定完成从 TranslationUnit 翻译结果到 raw-responses 文件和 artifact 交付的完整闭环。本文记录这次 AI 辅助翻译流程稳定性验证过程，并分析翻译能力与工程执行能力之间的差异。
-
本次重新评估 A Tour of Go 的 TranslationUnit 翻译方案，根本原因不是单纯比较模型能力，而是 ChatGPT 作为批量翻译引擎在实际工作中出现持续稳定性问题，即使从 ZIP 交付简化为 JSON，翻译任务仍可能卡住。实验使用 5 个正式 TranslationUnit、完整 zh-CN glossary、protected token、独立随机匿名和 Engineering Gate，对 ChatGPT GPT-5.6 High、Codex GPT-5.6 Sol High 与 Extra High 进行四模型匿名评审。结果显示，ChatGPT High 的外部评审平均分为 96.67，Codex High 为 95.73，Extra High 为 95.87，三者已进入相近的高质量梯队，而 Extra High 并未表现出稳定优势。综合翻译质量与本地批量执行能力，后续默认翻译引擎准备调整为 Codex GPT-5.6 Sol High，ChatGPT 则重点用于统一 Quality Check，并以所有 TranslationUnit 最终达到 A 作为质量验收目标。
-
A Tour of Go 多语言翻译项目的第二门社区语言 ja-JP 于 2026 年 8 月 24 日正式完成生产上线。日语版覆盖 103 个课程 Page 和 19 个 eligible Example，共 122 个 TranslationUnit，全部经过 automatic validation、Quality Check、Final Review 与 promotion，并完成公共 UI、课程目录、独立生产部署、Cloudflare Free、共享静态资源、Playground、SEO 与真实浏览器验收。Google Search Console 已成功处理 ja-JP sitemap 并发现 105 个公开网页。这次上线也真正验证了项目从 zh-CN 扩展到第二门语言的完整多语言架构。
-
A Tour of Go 日语版 ja-JP 正式上线后，我没有立即开始第三门语言，而是先复盘第二门语言从开发、翻译、质量审核、projection、production 部署到公网验收的完整过程，并将此前依赖临时分析和上下文记忆的环节固化为正式规范。项目新增 NEW_LOCALE_RUNBOOK.md 和 LOCALE_SURFACE_REVIEW.md，明确新增 locale 的统一入口、TranslationUnit 之外的完整语言质量审核、Rendered Surface Acceptance、首次生产部署与日常维护部署边界，以及 glossary 作为全站术语权威来源的职责，为后续第三门及更多语言建立可重复执行的标准化扩展流程。