在 A Tour of Go 多语言翻译项目中,课程内容、Playground 示例、生产部署和运行环境都采用公开源码与生产配置分离的设计。
当项目需要接入广告系统时,最初考虑直接增加 AdSense 相关配置。但经过分析后发现,广告平台未来可能发生变化,如果在代码结构中直接绑定 AdSense,会降低后续扩展能力。
因此,本次调整没有实现 AdSense 专用逻辑,而是将广告注入能力抽象为通用 HTML 注入机制。
最终实现:
- 统计代码继续使用独立注入;
- 广告代码使用独立注入;
- 生产环境通过 systemd 环境变量提供实际内容;
- 公开源码只保留注入位置,不包含任何广告账号信息。
为什么不直接将广告代码写入源码
对于公开源码项目,如果直接把广告代码写入模板:
<script async src="https://pagead2.googlesyndication.com/..."></script>那么任何拉取仓库并部署的人,都会默认使用相同广告配置。
这会造成:
- 源码和生产环境强绑定;
- 其他部署者无法独立配置;
- 广告平台切换困难;
- 公开仓库中包含不属于项目本身的运营配置。
因此,项目继续沿用已有统计代码注入方式:
生产环境配置
↓
systemd EnvironmentFile
↓
Go 服务读取
↓
模板渲染
↓
HTML head 注入从 AdSense 专用配置到通用广告注入
最初设计中,广告配置容易与 AdSense 平台绑定。
例如:
TOUR_ADSENSE_CLIENT这种方式只能表达:
“当前使用 AdSense”。
但是未来如果:
- 更换广告平台;
- 增加多个广告脚本;
- 使用其他 HTML 注入内容;
都需要重新修改代码结构。
因此,本次重构将其调整为:
TOUR_AD_HTML由环境变量直接提供需要注入的 HTML 内容。
对应提交:

Go 服务增加独立广告注入链路
新的注入链路:
TOUR_AD_HTML
↓
os.Getenv("TOUR_AD_HTML")
↓
template.HTML
↓
AdHTML
↓
{{.AnalyticsHTML}}{{.AdHTML}}
↓
HTML <head>实现中:
AnalyticsHTML继续负责统计代码;AdHTML负责广告 HTML;- 两者保持独立。
这样可以分别控制:
- 是否启用统计;
- 是否启用广告;
- 使用什么广告内容。

发布包只包含注入能力,不包含生产广告配置
项目发布流程生成 production bundle 时:
不会生成:
- AdSense client ID;
- 广告脚本;
- 生产环境配置。
发布包中的模板只保留:
{{.AnalyticsHTML}}{{.AdHTML}}
<meta charset="utf-8">也就是说:
源码和发布包知道“在哪里注入”。
但是不知道“注入什么”。

生产环境通过 systemd 注入广告代码
实际广告配置只存在生产服务器:
/etc/go-tour/go-tour.env其中:
TOUR_ANALYTICS='...'
TOUR_AD_HTML='<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=..."></script>'修改生产配置后,只需要重新启动服务。
整个流程:
/etc/go-tour/go-tour.env
↓
systemd EnvironmentFile
↓
go-tour.service
↓
读取 TOUR_AD_HTML
↓
模板渲染
↓
浏览器 HTML head
公网验证广告脚本输出
部署完成后,通过公网页面验证:
curl -sS https://go-dev.shuijingwanwq.com/ | grep pagead2返回:
https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js说明:
广告注入链路已经生效。
从生产配置到最终页面:
生产环境变量
↓
Go 服务
↓
HTML 渲染
↓
浏览器加载广告脚本整个过程没有修改公开源码中的广告账号配置。

总结
本次广告接入并不是简单添加一段 AdSense 脚本,而是进一步完善了 A Tour of Go 多语言翻译项目的生产配置架构。
最终实现:
- 广告逻辑与具体广告平台解耦;
- 公开源码不包含生产广告配置;
- 不同部署环境可以独立设置广告内容;
- 未来可以支持其他广告平台或自定义 HTML 注入。
通过环境变量注入机制,项目保持了:
公开源码
+
独立生产配置
+
可扩展部署方式这与项目已有的统计代码注入、Playground 代理、生产发布流程保持一致,为后续长期维护提供了更稳定的基础。
Go 学习与文档多语言本地化项目
本系列完整记录 Go 学习与文档多语言本地化项目从 A Tour of Go 起步,逐步扩展到站点首页、项目说明页、学习内容、文档以及未来内容包的实际开发过程,包括架构设计、统一术语治理、整页翻译、结构保护、自动校验、独立质量审核、生产发布与长期维护。
项目源码:
✅ GitHub:shuijingwan/go-tour-i18n
语言版本:
当前跨项目目标语言池共包含 66 个语言版本。Go 项目本身目前提供 65 个社区 Production 语言版本,下面每一门 Go 语言版本都直接链接到其当前公开站点。语言列表沿用项目首页现有的展示顺序。
英语(美国)仅作为跨项目目标语言纳入列表,并不是单独的 Go Production 语言版本。当前 Go 的英文源内容仍为官方 generic English,因此英语(美国)链接到 Go 官方站点,而不是不存在的本地社区部署。
- 阿姆哈拉语
- 阿拉伯语
- 孟加拉语
- 葡萄牙语(巴西)
- 保加利亚语
- 加泰罗尼亚语
- 克罗地亚语
- 捷克语
- 丹麦语
- 荷兰语
- 英语(美国)(Go 官方英文站点)
- 英语(澳大利亚)
- 英语(加拿大)
- 英语(印度)
- 英语(新加坡)
- 英语(南非)
- 英语(英国)
- 爱沙尼亚语
- 菲律宾语
- 芬兰语
- 法语(法国)
- 法语(加拿大)
- 德语(德国)
- 德语(奥地利)
- 德语(瑞士)
- 希腊语
- 古吉拉特语
- 希伯来语
- 印地语
- 匈牙利语
- 印度尼西亚语
- 意大利语
- 日语
- 卡纳达语
- 哈萨克语
- 韩语
- 西班牙语(拉丁美洲)
- 拉脱维亚语
- 立陶宛语
- 马来语
- 马拉雅拉姆语
- 马拉地语
- 书面挪威语(Bokmål)
- 波斯语
- 波兰语
- 葡萄牙语(葡萄牙)
- 旁遮普语(果鲁穆奇文,印度)
- 罗马尼亚语
- 俄语
- 塞尔维亚语(西里尔文)
- 简体中文(中国大陆)
- 简体中文(新加坡)
- 斯洛伐克语
- 斯洛文尼亚语
- 西班牙语(西班牙)
- 斯瓦希里语(坦桑尼亚)
- 瑞典语
- 泰米尔语
- 泰卢固语
- 泰语
- 繁体中文(台湾)
- 繁体中文(香港)
- 土耳其语
- 乌克兰语
- 乌尔都语
- 越南语
项目正在持续扩展新的 Go 学习与文档内容,并长期维护各语言版本的术语一致性、翻译质量、独立审核、生产发布与后续更新。
本项目属于非官方社区多语言本地化项目,与 Go 官方无隶属、授权或背书关系。

