代码即文档：逻辑清晰、规范至上的SEO工程实践

　　去年一月，凌晨三点十七分，我盯着那行 canonical 被套在 <noscript> 里还带双重 URL encode 的模板层，手没抖——是鼠标垫边缘被咖啡渍泡软了，一推就歪。张工蹲在机柜旁拿热风枪吹 SSD 散热片，说“这盘阵列掉盘不是温度的事”，我嗯了一声，其实根本没听，只看见他左手小指上那圈褪色的银戒，三年前他婚礼我喝多吐在酒店地毯上，他拿那戒指刮过我鞋帮上的泥。

　　优胜劣汰不是比喻。是真淘汰——去年整年我亲手删掉的 SEO 相关配置文件，比前五年加起来多两倍。删得最痛快的是那个用正则硬解析 HTML 再拼 meta 的 Node.js 中间件，我原以为它扛得住 SSR 水合差异，结果某天凌晨四点它把整个商品页的 og:image 全替成 base64 编码的 404 图标，而运维那边刚挂掉监控告警邮件的转发规则，没人知道。那会儿窗外下着冻雨，玻璃上全是斜拉的水痕，像有人用指甲反复划过。

　　代码即文档？呵。上周李婷改 header 组件，把 data-seo-priority="high" 改成布尔值 true，上线三小时后移动索引率掉了十八秒——不是百分比，是真实抓取耗时从平均二百七十二毫秒跳到三百零九。她改完顺手切了微信视频，镜头晃着，背景里她家猫正扒拉窗台的绿萝，土掉了一半。我没拦。我知道拦也没用，她前天刚跟测试吵完，说“你们连 rel=prev/next 还在手动填 href 就别碰路由表”。她说得对。但对不等于能跑通。

　　规范至上？我桌上那盒没拆封的凉皮已经放了四天，酱包渗出来，在塑料盒底洇开一小片暗红。它和规范一样，存在，但没人动。我们上周推的那个“结构化数据自动校验管道”，核心逻辑写在 lib/seo/utils/parse-ldjson.js 第三十七行注释里：“别信 schema.org 官方示例，他们上个月悄悄把 @type 值大小写混用了，本地 dev 环境校验通过，CI 不过”。这个我敢打包票。但那个 pipeline 在生产环境到底有没有跑满全部八百二十六种 schema 类型？我说不准。

　　那天下午茶歇，王总坐我对面啃苹果，咔嚓咔嚓，每口都停顿两秒，咽下去才开口问：“你们现在还手动写 robots.txt 吗？”我刚想说“早进 CI 了”，他手机响了，是个陌生号，他接起来就说“哎哟陈局您这会儿打来——”，声音瞬间拔高半个调，手指把苹果核捏得咔一声裂开。我低头看自己电脑右下角时间：十四点零七分。十五分钟后，他回来时袖口沾了点粉笔灰，是隔壁教研组黑板擦掉的——他们今天审高职评聘材料。

　　有次我们压测 hreflang 渲染链路，发现某条 fallback 路由在 Chrome 112 下生成了空 hreflang="x-default"，Google Search Console 当场报错，可 Edge 115 和 Safari 17.3 都正常。排查到第七个小时，张工突然把显示器转过去，指着一行被注释掉的 polyfill：“这儿，// FIXME: fetch() in IE11 breaks link[rel=alternate] mutation——IE11 我们早砍了啊。” 我说对，砍了，三年前砍的。结果发现那行注释底下还压着更老的 commit hash，是 2019 年一个实习生留的，当时他根本不知道我们早就不用 IE。这个注释，比所有现在线上跑的 hreflang 都老。

　　所以我说逻辑清晰就是活命线。不是因为漂亮，是因为一旦嵌套超过四层 promise + async/await + template literal + 动态 import，SEO 工程师的 debug 能力就直接退化成考古学——你不再调试代码，你是在碳十四测年。上个月有个需求，要把搜索词聚合页的 meta description 加个动态变量，产品提的文案是“找「{{keyword}}」的人，最后都点了这里”。开发写了二十行 JS 处理转义、截断、防 XSS，上线当天百度落地页描述全变成“找「」的人……”。后来发现是某个中间件在处理 {{keyword}} 之前，先跑了遍 markdown-it，把尖括号当 HTML 标签给干掉了。这事儿我本来不想提，但前天保洁阿姨拖地，水桶就搁我工位旁边，她弯腰拧拖把的时候，T 恤下摆翘起来，露出半截浅褐色胎记——形状像极了我们 Git Graph 里那个诡异的 merge conflict 节点。

　　我不信什么最佳实践手册。我信谁在 code review 里揪出过三处 noindex,follow 错写成 noindex,nofollow，且每次都是同一个人，连 comment 格式都一样：“见 PR#2873，已修复两次”。这个人叫陈默，上个月离职去了杭州，走前没办交接，只留了张便签贴在我显示器背面：“别信 git blame，信你第一次 commit 的那行 console.log。”

文章配图，仅供参考

　　下次再遇到用 innerHTML 拼 Schema 的人，我打算直接递他一盒凉皮。酱包必须漏。得让他亲手抹一手红油，才好理解什么叫——规范没死，它只是暂时结了痂。

（编辑：站长网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!