北京
一个被下载了数千次的新闻网站模板，邮件订阅功能整整坏了多久？答案是：没人知道。当谷歌编程之夏的申请者开始逐行审阅代码时，才发现这个"开箱即用"的 starter kit 里，连表单提交都是个摆设。
2024年谷歌编程之夏的申请季，一位实习生花了三周时间通读 wagtail/news-template 的代码库。他的发现写成了一份 bug 清单——不是边缘 case，是核心功能集体罢工。
暗坑一：邮件订阅是个"假按钮"
Newsletter 注册框看着挺像回事。输入框、提交按钮、成功提示，UI 完整。但代码里，email 输入框没有 name 属性，提交按钮是个 `` 标签，跟表单毫无关联。
用户填完邮箱点击提交，页面刷新，数据消失，没有任何请求发出。
这位实习生在 PR #107 里修复了这个问题。他后来写道：「Every visitor who tried to sign up got no result」——每个尝试订阅的访客都扑了个空。没人统计过这个"静默失败"持续了多久，损失了多少潜在用户。
暗坑二：手机导航的"鬼打墙"
移动端菜单展开后，点击任何链接都会回到当前页面。原因是某次代码回归（regression）把 href 属性清空了，留下一串空的 `href=""`。
这个问题在 PR #101 被修复。讽刺的是，桌面端导航完全正常——移动端用户被区别对待了整整一个版本周期，却没人投诉。可能因为移动端流量占比不高，或者用户直接放弃离开了。
暗坑三：推荐文章块输出"源代码"
FeaturedArticleBlock 是个灵活的编辑工具，支持覆盖文章图片、描述和 CTA 文案。但模板文件是个 stub（存根），只渲染原始数据而非 HTML。
编辑在后台精心配置的内容，前端显示的是 Python 字典的字符串形式。PR #103 补上了这个模板。换句话说，这个"特色功能"从发布到修复，可能从未被真正使用过。
暗坑四：运行时炸弹
utils/models.py 调用了 slugify() 却没导入。news/models.py 引用了分页异常类，但 import 语句缺失。这两个 NameError 像地雷埋在代码里，触发条件简单到可笑：访问特定页面即可引爆。
测试覆盖率解释了为什么这些 bug 能存活：整个项目只有三个测试，核心模型、模板标签、视图全部裸奔。
暗坑五：无障碍合规的"形式主义"
表单输入框没有 `` 元素，只有 placeholder 文字。这违反了 WCAG 2.1 AA 标准——屏幕阅读器用户无法识别字段用途。
PR #99 修复了这个问题。但更值得玩味的是：一个面向新闻媒体的开源模板，本身就在服务信息获取的弱势群体，却在无障碍上偷工减料。
为什么这些 bug 能藏这么久？
wagtail/news-template 的设计本身并不差。内容模型扎实：ArticlePage 支持作者、话题、发布日期、头图；StreamField 让编辑零代码搭建文章体；Tailwind CSS 的响应式设计、默认开启的暗黑模式，都是加分项。
但开源项目的"模板"定位制造了盲区。用户下载后通常会大量修改，原始 bug 被覆盖或忽略；核心团队可能把维护优先级放在 Wagtail 本体而非周边模板；测试文化的缺失让回归变得容易。
这位实习生的收获写在最后：「Contributing fixes taught me more about Wagtail than any tutorial could」——修 bug 比看教程学得更快。这是开源社区的经典悖论：缺陷即教材。
修复后的模板现在有了 RSS 订阅、作者资料页、Open Graph 社交分享标签。但那个问题依然悬着：还有多少被广泛使用的开源 starter kit，正在以"开箱即用"的名义，让用户替开发者做 QA？
特别声明：以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布，本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
