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

A Tour of Go 明明有大片空白,为什么 AdSense 就是不显示展示广告?

图 1:课程正文结束以后,页面左侧仍然存在大块视觉空白,但 AdSense 并没有在这里插入展示广告。

作者:

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

图 1:ja-JP 上线以后,先提交“新增语言标准化流程”

(50) A Tour of Go 多语言扩展复盘:为第三门语言建立标准化流程

图 1:课程正文结束以后,页面左侧仍然存在大块视觉空白,但 AdSense 并没有在这里插入展示广告。

(51) A Tour of Go 明明有大片空白,为什么 AdSense 就是不显示展示广告?

最近在继续完善自己的 A Tour of Go 多语言站点时,我遇到了一个看起来有些反直觉的问题:

Google AdSense 自动广告已经启用,广告脚本也正常加载,但课程页面中的展示广告始终没有出现。

更奇怪的是,从人的视角来看,页面明明存在很大一块空白区域。

乍一看,这里似乎非常适合放一个展示广告。

但实际情况是:无论等待多久、刷新多少次,这些空白区域里都没有出现普通的页面展示广告。

这也成为后续一系列 A Tour of Go 广告、SPA、SEO 和 Prerender 调整的起点。

页面明明有这么大的空白

最初让我觉得奇怪的,就是课程页面本身。

A Tour of Go 使用左右分栏布局:

左侧是课程说明,右侧是代码编辑器和运行结果。

有些课程内容比较短,于是在左侧正文结束以后,会留下非常明显的大块空白。

图 1:课程正文结束以后,页面左侧仍然存在大块视觉空白,但 AdSense 并没有在这里插入展示广告。
图 1:课程正文结束以后,页面左侧仍然存在大块视觉空白,但 AdSense 并没有在这里插入展示广告。

从截图里看,红框区域相当大。

如果仅仅按照人的视觉判断,这里放一个矩形广告似乎完全没有问题。

所以我一开始也很自然地想到:

是不是 AdSense 自动广告根本没有启用?

或者广告代码没有正确加载?

先确认 Auto Ads 本身已经启用

首先检查 Google AdSense 后台。

站点的自动广告确实处于启用状态。

图 2:AdSense 后台中,shuijingwanwq.com 的自动广告已经处于启用状态。
图 2:AdSense 后台中,shuijingwanwq.com 的自动广告已经处于启用状态。

这意味着问题不能简单解释为:

“忘记打开 Auto Ads。”

至少从 AdSense 配置来看,Google 已经被允许自动寻找适合的广告位置。

不过,仅仅后台显示“启用”,还不能证明浏览器端的广告代码真的正常工作。

于是继续检查页面实际加载的网络资源。

adsbygoogle.js 也确实加载成功

打开浏览器开发者工具,在 Network 中搜索 adsbygoogle

可以看到:

Plaintext
pagead2.googlesyndication.com
adsbygoogle.js
HTTP 200
图 3:页面已经成功加载 Google AdSense 的 adsbygoogle.js,HTTP 状态为 200。
图 3:页面已经成功加载 Google AdSense 的 adsbygoogle.js,HTTP 状态为 200。

至此,可以排除两个最直观的问题:

  • Auto Ads 并没有关闭;
  • AdSense 主脚本也不是因为网络或页面配置完全没有加载。

但页面里依然没有普通展示广告。

这时候问题就开始变得有意思了。

“看起来有空白”不等于“DOM 中存在广告位置”

一开始我其实潜意识里做了一个假设:

浏览器页面上有一大片白色区域,就意味着 Google 可以在那里插入一个广告。

后来发现,这个假设并不成立。

浏览器最终显示出来的是一个二维画面。

而 Google 判断广告能否插入时,面对的并不只是这张“截图”,而是实际的 HTML、DOM 结构和 CSS 布局。

换句话说:

人看到的是空白像素,广告系统看到的却是元素、容器、定位关系以及文档流。

两者不是一回事。

这一点在 A Tour of Go 上尤其明显。

A Tour of Go 本身不是普通文章页面

为了进一步确认这一点,我直接查看了官方 A Tour of Go:

Plaintext
https://go.dev/tour/welcome/3

这里使用官方页面作为结构参考,是因为自己的多语言版本一直尽量沿用上游 A Tour of Go 的课程架构,而不是重新实现一套完全不同的页面。

打开开发者工具以后,可以看到课程主体大致存在这样的层级:

Plaintext
ng-view
└── #editor-container
    ├── .relative-content
    │   └── #left-side
    │       └── .relative-content
    │           └── .slide-content
    └── #right-side
图 4:官方 A Tour of Go 的课程页 DOM 结构。左侧课程内容、右侧编辑器都位于专门的 editor-container 和 relative-content 布局体系中。
图 4:官方 A Tour of Go 的课程页 DOM 结构。左侧课程内容、右侧编辑器都位于专门的 editor-container 和 relative-content 布局体系中。

图中选中了左侧的 .slide-content

浏览器同时用蓝色区域标出了这个元素实际占据的布局区域。

这个截图让我更容易理解之前那个现象:

页面上看起来还有很多白色区域,并不代表这些区域在 DOM 中就是一段普通、连续、适合插入广告的文档流。

A Tour of Go 本质上是一个交互式课程应用,而不是传统博客文章。

它有自己的:

  • 左右分栏;
  • 编辑器区域;
  • 相对定位关系;
  • 页面高度计算;
  • SPA 页面切换;
  • 固定的课程交互结构。

在这种布局中,“某个位置现在没有文字”与“这里存在一个 Google 可以安全插入展示广告的容器”,完全是两个概念。

为什么视觉空白可能无法成为广告位

传统文章页面通常比较简单:

Plaintext
正文
正文
正文

广告

正文
正文

所有内容都顺着正常文档流从上向下排列。

如果 Google 在两个块级内容之间插入一个广告,页面通常只需要自然向下延伸即可。

但 A Tour of Go 的课程页并不是这样的结构。

它更接近:

Plaintext
┌─────────────────┬─────────────────┐
│                 │                 │
│    课程内容      │    代码编辑器    │
│                 │                 │
│                 │                 │
│    视觉空白      │    运行结果      │
│                 │                 │
│                 │                 │
└─────────────────┴─────────────────┘

这里左侧正文结束以后产生的“空白”,实际上仍然属于整个左右分栏布局的一部分。

它不是简单的:

Plaintext
<p>正文结束</p>

这里什么都没有

<footer>

所以即使人在截图里觉得:

这里至少还能放一个 300×250 的广告。

Google 的自动布局逻辑也未必会得出相同结论。

广告系统还必须考虑这个位置插入新元素以后:

  • 是否会破坏已有布局;
  • 容器有没有稳定尺寸;
  • 广告是否处于正常可见区域;
  • 页面重新布局以后是否仍然合理;
  • 与其他页面元素之间是否存在冲突;
  • 当前结构是否适合自动创建一个广告节点。

这也是为什么单纯依靠“页面还有空白”来判断 Auto Ads 是否应该展示,并不可靠。

到这里,问题范围已经明显缩小

经过这一轮检查以后,至少可以确认:

Plaintext
Auto Ads 已启用

adsbygoogle.js 加载成功

页面存在大量视觉空白

普通展示广告依然没有出现

因此,问题已经不能继续简单归结为 AdSense 没有工作。

更合理的方向变成了:

A Tour of Go 原有的 DOM 和页面布局,并没有为 Google Auto Ads 提供它能够正常使用的页面内展示广告位置。

需要说明的是,这并不是说我能够从浏览器端精确知道 Google 内部为什么拒绝某一个具体位置。

Google 的自动广告决策本身属于黑盒。

所以更准确的表述应该是:

从实际现象和页面结构来看,Auto Ads 没有把人眼看到的这些空白区域识别为适合自动插入普通展示广告的位置。

截至后来继续排查时,我也一直没有在这些课程页面上真正看到 Auto Ads 自动插入普通的页面展示广告。

因此,继续单纯等待 Google“总有一天自己找到位置”,已经不是一个很可靠的方案。

这又引出了一个更大的问题

如果原来的 A Tour of Go 页面结构不适合自动广告,那么最直接的解决方法似乎是:

修改页面结构。

甚至可以进一步考虑:

干脆放弃现有 SPA,让每一节课程都变成传统的独立页面。

这样一来:

  • 页面结构更接近普通文章;
  • 每次点击下一页都会重新加载页面;
  • AdSense 可以重新执行;
  • SEO 也会变得更加直接。

从广告角度看,这条路线其实很诱人。

但 A Tour of Go 并不是一个为了广告而存在的网站。

自己的版本长期还需要跟踪和同步上游 golang/website

如果为了 AdSense 大幅改变上游的页面架构,今天解决的是广告问题,未来增加的可能却是长期维护成本。

所以问题从这里开始发生了变化。

最初的问题只是:

为什么明明有这么大的空白,却没有广告?

排查到最后,真正需要决定的却变成了:

为了 AdSense,到底值不值得放弃 A Tour of Go 原来的 SPA 架构?

这也成为下一阶段需要做出的架构选择。

A Tour of Go 多语言扩展复盘:为第三门语言建立标准化流程

A Tour of Go 多语言翻译项目

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

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

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