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

广告之外,社区项目如何长期活下去?我给 A Tour of Go 多语言项目加了 Support

【图 3:简体中文站 Support 页面】

作者:

在

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 和百度的搜索表现差距有多大?

最近,我给 A Tour of Go 多语言项目增加了一个以前一直有些犹豫的功能:

Support the project。

简体中文站提供微信和支付宝;面向国际用户的语言站,则提供 USDC、USDT,以及 Binance、OKX 平台内转账等方式。

从技术实现来看,这并不是项目里最复杂的功能。

真正让我考虑很久的,是另一个问题:

一个免费、开源的社区项目,在页面里增加“支持项目”入口,到底合不合适?

这次最终决定加入 Support,也不是一个孤立的决定。

它其实和我前段时间重新研究 A Tour of Go 历史上的社区翻译项目密切相关。


一、这件事要从那些已经离线的社区翻译说起

9 月 3 日,我写过一篇文章:

《从法语 553 次提交到韩语两代离线:A Tour of Go 社区翻译为什么难以长期维护》。

那次重新调查历史项目以后,我印象最深的,不是曾经有多少种语言,而是:

很多社区翻译曾经投入了大量时间,最后还是停止维护甚至彻底离线。

法语项目就是一个很典型的例子。

仓库历史上能够看到:

Plaintext
553 Commits
61 Contributors

进一步排除能够识别出的官方上游历史以后,我当时统计到的 fork-only 历史仍然有:

Plaintext
162 fork-only commits
14 个 fork-only Git author name
超过 11 年的活动跨度

最后仓库还是 archived,Production 站点也已经离线。(永夜)

韩语更让我印象深刻。

第一代项目长期无人维护以后,又有人重新建立了第二代项目:

Plaintext
第一代离线
→ 新维护者重新翻译和迁移
→ 建立新的 Production
→ 再次进入官方语言列表

几年以后,第二代韩语仍然再次 OFFLINE,官方也重新移除了链接。(永夜)

所以我后来越来越认同一个判断:

社区翻译真正困难的,往往不是第一次把一门语言翻译出来,而是五年、十年以后,它还有没有条件继续存在。


二、一个翻译项目的“维护”,远不只是继续翻译

如果只看最终结果,很容易把历史项目的离线理解成:

维护者后来没有继续翻译。

但实际问题远比这复杂。

历史上的 A Tour of Go 社区翻译曾经共同面对过:

Plaintext
上游不断变化
runtime 淘汰
App Engine 部署失效
production ownership
部署权限
技术债
Bus Factor
维护者时间变化
基础设施成本

Go 官方过去甚至专门处理过 App Engine runtime 淘汰以后,社区 Tour 无法重新部署的问题。

翻译文本可能还好好地留在 GitHub。

真正先断掉的却可能是:

Plaintext
runtime
→ deployment
→ hosting
→ production site
→ official link

一旦其中某个环节长期无人处理,对普通学习者来说,这门翻译实际上也就“消失”了。(永夜)

这也是为什么现在的 go-tour-i18n 花了大量精力在翻译之外:

Plaintext
Translation Workflow
Quality Check
Locale Surface Review
Production
CDN
自动验收
上游同步
正式文档
搜索引擎

我希望留下的不只是:

今天这个站已经上线。

还应该尽量留下:

几年以后,它仍然有继续维护和接手的条件。


三、历史上的中文社区维护者,也曾对商业模式感到无奈

在上一篇文章里,我还记录过一个让我很有感触的细节。

我以前看到过中文社区维护者表达过类似的无奈:

这种项目很难谈什么商业模式。

当时我没有重新找到那句话的原始出处,所以没有把它作为可核实的直接引文,只保留了这个大致意思。(永夜)

现在继续做这个项目,我越来越能够理解这种感受。

社区翻译通常意味着:

Plaintext
免费访问
不开会员
不卖课程
不卖软件
没有订阅
也很难有稳定企业合同

从学习者角度来看,这当然很好。

但对于长期维护来说,就会自然产生另一个问题:

项目依靠什么持续运行?

这个问题在项目刚上线的时候并不明显。

一年、五年、十年以后,差别就会越来越大。


四、社区项目免费,并不意味着运行它没有金钱成本

开源代码可以免费放在 GitHub。

翻译内容也可以免费提供给所有人。

但一个真正在线运行的多语言项目,仍然存在持续的金钱投入。

以我现在的 A Tour of Go 多语言项目为例,背后涉及:

Plaintext
服务器
海外网络节点
域名
公网带宽
CDN
DNS / 网络服务
监控和日志
Production 存储
AI 工具

其中一些能力确实可以使用免费方案。

例如目前不少 community locale 使用 Cloudflare Free。

但:

Plaintext
部分基础设施免费 ≠ 整个项目没有运行成本

服务器、域名、网络和各种维护工具叠加起来,仍然需要长期投入。

这些属于比较容易量化的金钱成本。

但实际上,还有另一部分往往更容易被忽略。


五、比账单更难量化的,是长期投入的时间和精力

随着语言越来越多,真正需要持续投入的已经不仅是金钱。

例如一次上游同步,可能涉及:

Plaintext
检查 upstream
→ 判断 TranslationUnit 变化
→ 翻译 / revision
→ validation
→ Quality Check
→ promotion
→ Locale Surface Review
→ preview
→ Production
→ browser acceptance

遇到故障以后,还可能继续处理:

Plaintext
systemd
Nginx
CDN
DNS
TLS
Playground
浏览器兼容
搜索引擎

这些都不会出现在任何云服务账单里。

但它们同样是真实成本。

甚至对于一个社区项目来说,这部分长期人力和精力投入,往往比服务器本身更加稀缺。

所以长期维护实际上至少包含两类不同成本:

Plaintext
一类是可以直接计算的:
服务器、域名、CDN、工具等金钱投入
另一类是很难直接计价的:
维护者持续投入的时间、注意力、知识和精力

前者需要项目有条件继续运行。

后者则决定了有没有人愿意长期把这件事情放在自己的优先级里。

两者最终都会影响一个社区项目能不能坚持很多年。


六、最初我想到的可持续方式,还是广告

A Tour of Go 多语言站一直保持免费访问。

所以最自然的一种运营方式就是:

Plaintext
免费内容 + 广告

用户不用注册,也不需要支付课程费用。

如果未来能够获得稳定的自然搜索访问,广告就可以帮助承担一部分:

Plaintext
服务器和网络
CDN 与域名
维护工具
长期 Production 运行

也就是说,它的意义并不仅仅是产生一项收入数字。

更重要的是让:

用户使用项目产生的流量,能够反过来分担项目自身的一部分长期运行成本。

这样项目就不再完全依赖单一维护者持续投入金钱。

不过,我现在也不太愿意把增加多语言版本简单描述成:

Plaintext
更多语言
→ 更多页面
→ 更多广告收入

因为那会把整个项目的目标说得太窄。

更准确的逻辑应该是:

Plaintext
更多语言
→ 更多开发者可以使用自己熟悉的语言学习
→ 更多地区的用户和搜索引擎能够发现这些内容
→ 社区项目的覆盖范围扩大
→ 同时增加长期可持续运营的可能

首先还是让内容真正被人发现和使用。

收入是项目长期运行条件中的一部分,而不是唯一目标。


七、现在的 AdSense 数据仍然非常有限

从最近 7 天的数据来看,go-dev 多语言项目目前通过 AdSense 获得的收入还很少。

【图 1:AdSense 最近 7 天 go-dev 多语言站点数据】
【图 1:AdSense 最近 7 天 go-dev 多语言站点数据】

其中很多语言站仍然显示:

Plaintext
US$0.00

不过,这里不能直接把它理解成:

这些语言没有流量价值,或者项目没有意义。

首先,很多 locale 本身才刚刚上线。

更重要的是,目前已经被 Go 官方加入翻译列表的 4 个站点,我已经撤销了广告展示。

因此现在的广告数据,本身就混合了两种不同状态:

Plaintext
一部分站点:
继续通过广告分担运营成本
另一部分站点:
为了进入官方语言入口,已经不再展示广告

这也带来了一个非常现实的取舍。


八、官方链接和广告之间,我最终更看重“被发现和使用”

对于一个社区翻译项目来说,能够进入 Go 官方 A Tour of Go 的语言列表,非常有价值。

它解决的首先不是收入问题,而是:

发现问题。

一个新的语言站即使已经:

Plaintext
上线
有 sitemap
提交搜索引擎
完成 SEO

也不意味着目标用户马上知道它存在。

而官方链接则完全不同。

访问官方 A Tour of Go 的开发者,可以直接看到:

这里还有自己的语言版本。

这正是社区翻译最希望发生的事情。

所以目前存在一个很明显的选择:

Plaintext
加入官方链接
→ 更容易被目标开发者发现和使用
→ 但需要撤掉广告
不加入官方链接
→ 可以继续保留广告
→ 但新站获得稳定曝光会困难很多

如果只看短期收入,可能会倾向于后者。

但如果回到社区翻译本身的意义:

做出来,是希望有人真正使用。

那么官方入口的价值就不能只用广告展示量计算。

所以这 4 个语言站即使撤掉广告,我仍然认为加入官方链接是更有价值的选择。


九、这也意味着广告不能成为唯一的可持续方式

这个取舍也让我开始重新思考一个问题:

如果社区项目只有广告这一种收入来源,那么恰恰在最有价值的官方曝光渠道上,它可能完全无法使用。

这并不意味着应该放弃官方链接。

也不意味着应该想办法重新把广告塞回去。

更合理的方向是:

让项目的长期可持续性不要只依赖一种方式。

于是我才开始真正考虑:

Support。


十、我为什么一直对 Support 有一些心理负担?

开源世界里,自愿支持其实非常普遍。

GitHub Sponsors、OpenCollective,以及很多独立项目自己的赞助页面,都不是什么新鲜事。

但真正轮到自己的项目时,我还是会觉得有些别扭。

这种心理到底有多少和中文传统文化有关,我不太敢简单下结论。

如果直接归因成:

儒家文化轻商。

我觉得反而太武断了。

“义利”“士商”“商业活动在传统文化中的位置”本身就是一个很大的历史和社会话题,不适合在这篇技术项目文章里下简单结论。

但至少从我自己的感受来说:

在中文语境里,公开讨论收入、赞助、支持,往往会比单纯讨论技术多一层心理压力。

很容易担心:

Plaintext
会不会显得太功利?
会不会让人觉得是在伸手要钱?
一个开源项目谈这些合不合适?

所以我以前更容易接受广告。

因为广告看起来是:

Plaintext
用户继续免费使用
广告主承担费用

而 Support 则需要直接面对:

是否愿意支持这个项目?

后来我才慢慢觉得,这两件事情并不需要对立起来。


十一、允许用户自愿支持,不等于改变项目的开放属性

A Tour of Go 多语言站增加 Support 以后,并不会改变原来的使用方式。

不支持项目的人仍然可以:

Plaintext
免费访问
免费学习
免费使用 Playground
查看全部课程

不会出现:

Plaintext
支持后才能解锁章节
支持后才能运行代码
支持后才能使用完整功能

而且项目源码本身仍然公开。

如果有人不希望使用我部署的 Production 站点,或者不希望看到其中的广告,他仍然可以:

Plaintext
查看源代码
自己部署
继续传播

Support 没有把开源内容变成付费内容。

它只是增加了一个新的选择:

如果这个项目对你有价值,而且你愿意参与它的长期维护,可以提供自愿支持。


十二、所以我最终把 Support 正式做进了项目

这个功能也不是一次完成的。

Git 历史里能够看到它逐渐完善的过程。

【图 2:Support 功能演进时间线】
【图 2:Support 功能演进时间线】

最初是:

Plaintext
feat: 添加多语言项目支持入口

然后是:

Plaintext
feat: 完善多语言项目支持方式

最后又增加:

Plaintext
feat: 增加英文 README 并优化项目支持展示

从一个简单入口,逐渐变成一个需要考虑:

Plaintext
不同语言
不同地区
不同支付习惯
UI
移动端
复制交互
翻译
Production

的正式功能。


十三、到底是“支持整个项目”,还是“支持某个语言版本”?

这个问题我后来也专门考虑过。

如果每一个语言页面都写一个 Support,很容易让人产生一种感觉:

为什么到处都在要求支持?

所以需要把层次说清楚。

从项目整体来看:

Support 面向的是整个 go-dev 多语言项目的持续维护。

GitHub README 使用的也是:

Plaintext
Support the project

因为很多基础设施本身就是共享的:

Plaintext
代码仓库
Production tooling
shared assets
维护流程
CDN / 网络能力
AI 工具
长期工程维护

但用户真正进入某一个语言站时,他看到的又是一个具体 locale。

所以站内页面会把 Support 表达成:

支持当前语言版本继续维护和发展。

例如简体中文站,就是:

Plaintext
支持简体中文版本

韩国站则对应韩语版本。

这样做的意义不是把整个项目拆成几十个完全独立的“小项目”。

而是让用户清楚知道:

自己当前使用的是哪个社区语言版本,支持会帮助这个版本以及背后的共享项目继续维护。

因此可以把两层关系理解成:

Plaintext
GitHub / 项目层:
支持整个多语言项目
具体 locale 页面:
从当前语言版本的角度提供 Support 入口

这样既不会让项目层级显得混乱,也能让每个语言站的用户看懂这个入口和自己有什么关系。


十四、中文站首先提供最自然的国内方式

简体中文站目前主要提供:

Plaintext
微信支付
支付宝
【图 3:简体中文站 Support 页面】
【图 3:简体中文站 Support 页面】

页面里的核心表达是:

帮助这个语言版本持续维护和发展。

这里强调的并不是一次性的“打赏”,而是让 Support 和项目本身的长期运行联系起来。

它对应的是这个语言版本背后的持续工作,例如:

Plaintext
翻译更新
上游同步
Production
基础设施
长期维护

也就是说,Support 在页面里被放在了“项目持续维护”这个语境中,而不是单独作为一个收款入口存在。


十五、一个多语言社区项目,也不能只提供国内支付方式

项目既然面向国际用户,那么只放微信和支付宝显然不够。

所以国际版本里,我增加了:

Plaintext
USDC — Base
USDT — Tron (TRC20)

以及可选的:

Plaintext
Binance
OKX

平台内转账。

【图 4:英文 README 中的 Support the project】
【图 4:英文 README 中的 Support the project】

如果用户和项目维护者恰好使用同一个平台,UID 内部转账在一些场景下可以减少小额链上转账的不便。

当然,实际是否可用和费用如何,仍然应该以平台当时显示为准。


十六、Support 最后也进入了真正的多语言 Production 页面

后来我并没有把这些内容只停留在 GitHub README。

Support 也正式进入了各个语言站。

例如韩语站:

【图 5:韩语正式站 Support 页面】
【图 5:韩语正式站 Support 页面】

页面中的:

Plaintext
标题
说明
资产
网络
地址
最低金额
风险提示
平台内部转账

都和其他 UI 一样完成本地化。

这意味着 Support 已经不只是:

Plaintext
README 里附带的一段收款信息

而是一个正式的多语言 surface。

因此它同样需要经过:

Plaintext
Locale Surface Review
Production
browser acceptance

这也是为什么我现在更愿意把它称为:

项目支持功能。


十七、谁可能会真正使用 Support?

教程网站和普通软件服务不太一样。

A Tour of Go 并不是一个用户每天都需要打开的工具。

很多人的使用路径可能只是:

Plaintext
搜索到教程
→ 学习一次
→ 解决问题
→ 以后偶尔复习
或者推荐给其他人

所以我现在不再把 Support 想象成:

只有“长期高频用户”才会使用。

更合理的情况可能是:

某个人只使用过一次,但觉得这个翻译对自己确实有帮助,因此愿意表达一次支持。

也可能有人长期关注项目。

也可能绝大多数用户只是免费使用,然后离开。

这些都很正常。

Support 面向的不是某一种固定“付费用户画像”。

它只是给所有愿意回馈项目的人保留一个入口。


十八、广告和 Support 解决的是不同问题

广告适合:

Plaintext
大量普通访问
→ 每一次贡献很小
→ 聚合成一部分运营收入

Support 更像是:

Plaintext
少量用户主动认可项目
→ 自愿提供一次或多次支持

它们对应的是完全不同的行为。

而官方链接又是第三个维度:

Plaintext
让更多目标开发者真正发现和使用项目

所以现在我的思路越来越不是:

选广告,还是选 Support?

而是:

Plaintext
官方入口
→ 提高发现和使用
广告
→ 在适合展示广告的站点分担部分运营成本
Support
→ 给愿意主动回馈项目的人一个入口

几种方式可以同时存在,各自解决不同的问题。


十九、Support 本身不会创造用户

这一点也需要保持很现实的预期。

项目增加:

Plaintext
微信
支付宝
USDC
USDT
Binance
OKX

并不会自动产生任何收入。

如果:

Plaintext
没人发现
没人使用
没人觉得有价值

那么再完整的 Support 页面也没有意义。

所以 Support 不是一个流量增长策略。

真正重要的事情依然是:

Plaintext
翻译质量
语言覆盖
官方链接
搜索引擎发现
Production 稳定
长期维护

Support 做的只是:

当真的有人愿意支持时,项目已经准备好了一个合适的入口。


二十、我仍然希望项目逐渐形成可持续的收入,但这应该建立在社区价值之后

完全不谈收入并不现实。

一个需要长期维护的项目,如果未来能够逐渐产生稳定收入,就意味着维护者可以投入更多时间,也意味着项目更有可能获得长期持续维护。

但顺序很重要。

我更希望是:

Plaintext
项目首先有价值
→ 更多语言真正被使用
→ 社区影响逐渐扩大
→ 形成一定的可持续收入
→ 继续投入维护

也就是说,收入首先应该帮助项目:

Plaintext
承担运行成本
降低长期维护压力
增加继续投入的条件

如果有一天项目规模真的足够大,能够让维护工作本身获得更稳定的回报,我认为那反而是一种健康的结果。

因为社区项目并不是只有“完全无偿”才算社区项目。

持续、稳定、有人愿意长期投入,同样重要。


二十一、除了金钱成本,还需要让维护者的时间投入变得可持续

前面区分了两类成本:

Plaintext
金钱投入 + 时间与精力投入

收入最直接能够帮助的是第一类。

例如:

Plaintext
服务器
CDN
域名
网络
AI 工具

但如果一个项目逐渐拥有稳定的运营能力,它也会间接影响第二类。

因为维护者不再需要面对:

Plaintext
项目越来越大
+ 所有成本自己承担
+ 所有维护时间仍然只能不断挤出来

这种结构。

换句话说:

经济上的可持续,并不是为了替代社区价值,而是为了给长期维护创造更好的条件。

这也正好回到了历史上的那些项目。


二十二、这和法语、韩语曾经离线的问题重新连接起来了

历史上的法语项目有:

Plaintext
553 次提交
61 个 Contributors
多年维护历史

最后仍然归档。

韩语甚至经历了:

Plaintext
第一代
→ 离线
第二代
→ 重建
→ 再次上线
→ 最后再次离线

这些项目的离线当然不能简单归因于“没有收入”。

没有足够 evidence 支持这种直接因果关系。

更真实的情况很可能是多种因素共同作用:

Plaintext
Bus Factor
维护者变化
runtime 淘汰
部署权限
production ownership
上游变化
时间不足
技术债
基础设施成本

但经济因素同样很难完全排除。

因为如果项目长期要求:

Plaintext
有人持续贡献时间
+ 有人持续承担金钱成本
+ 却没有任何反馈机制

那么随着维护者自己的工作、家庭和生活发生变化,这个项目的优先级自然可能下降。

所以我现在更愿意把 Support 看成:

长期维护系统里的一个小补充。

它不会解决所有问题。

但它至少增加了一种让项目继续运行的可能。


二十三、真正重要的不是 Support 本身,而是减少对单一维护者的绝对依赖

如果一个社区项目想运行几个月:

维护者自己承担所有成本,通常并不难。

但如果目标是:

Plaintext
持续同步 Go 官方
不断增加语言
五年以后仍然在线
十年以后仍然有人维护

就必须考虑更长周期的问题。

例如:

Plaintext
文档能不能留下?
Production 能不能接手?
代码能不能继续维护?
权限能不能转移?
运行成本有没有长期来源?

我现在希望 go-tour-i18n 尽量做到:

Plaintext
流程可以继承
代码可以继承
Production 可以继承
文档可以继承
运行成本也不必永远完全依赖一个人

Support 只是最后这一项的一种尝试。


二十四、社区项目的可持续方式,也不需要只有一种

目前我能够想到的可能包括:

Plaintext
广告
自愿 Support
未来可能的企业赞助
社区资源支持
技术合作

并不是每一种都一定会出现。

也不需要为了“商业模式完整”而提前把它们全部做出来。

现阶段:

Plaintext
广告 + Support

已经足以进行长期真实验证。

以后如果有新的真实需求,再继续增加。

我现在越来越不想追求:

找出唯一正确的收入模式。

更重要的是:

有没有一种组合,既不破坏免费和开放,又能提高项目长期存在的概率。


最后:Support 不是一个孤立的收款页面,而是长期维护体系的一部分

所以这次给 A Tour of Go 多语言项目增加 Support,我现在更愿意把它放回整个项目历史里理解。

它并不是突然多出来的一项“收入功能”。

而是在继续回答一个早就存在的问题:

社区翻译怎样才能更长时间地活下去?

历史已经证明:

第一次上线并不是终点。

一个项目真正长期存在,需要:

Plaintext
语言质量
上游同步
技术维护
Production ownership
部署能力
文档和知识传承
基础设施
时间投入
经济可持续性

缺少其中任何一部分,几年以后都可能成为新的风险。

这也是为什么现在的 go-tour-i18n 不仅要解决:

Plaintext
怎样翻译?
怎样验证?
怎样上线?

还要逐渐回答:

Plaintext
怎样让更多人真正发现和使用?
怎样让未来的维护者能够接得住?
怎样让项目拥有承担一部分自身长期成本的能力?

广告是一种方式。

Support 是另一种方式。

官方链接则帮助社区翻译真正到达需要它的人。

它们并不需要互相排斥。

对于我来说,最希望保持的原则仍然很简单:

Plaintext
免费
开放
多语言
持续维护

如果有一天,这个项目能够在持续帮助更多开发者的同时,也逐渐形成足够稳定的运营条件,让维护本身能够长期继续下去,那应该是一个很理想的结果。

毕竟从那些已经离线的社区翻译回头看:

把一个语言版本做出来已经不容易。

但更难的,可能一直都是:

十年以后,它仍然在线,也仍然有人愿意、有人能够继续维护。

Cloudflare 缓存 HIT 很快,MISS 却不稳定:回源阿里云杭州的一次真实优化 从 Go Weekly 到 Reddit、DEV 和 Go Forum:第一次系统推广 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 官方无隶属、授权或背书关系。