网站旁注这东西，网站旁注最早就是网站旁注页面边上一条窄窄的竖栏。2005年我搭第一个博客，网站旁注右侧栏塞了日历、网站旁注友情链接、网站旁注计数器，网站旁注还有一张“本站已运行XX天”的网站旁注动图。那时候没人叫它旁注，网站旁注都叫侧边栏。网站旁注真正让我意识到它变了，网站旁注是网站旁注去年翻一个独立开发者的产品页——正文只有三屏，旁边却挂了一长串东西：更新日志、网站旁注快捷键说明、网站旁注一个实时显示服务器延迟的网站旁注小灯，还有三行用等宽字体写的网站旁注API调用示例。正文讲什么我忘了，那条旁注我盯着看了两分钟。

旁注正在从装饰品变成正文的注释层。以前它装的是“关于博主”“最新评论”，现在装的是正文放不下、又舍不得删的东西。一个写Rust教程的站点，正文里只贴了核心代码，旁注里却放了cargo命令的完整输出、报错截图、以及作者自己踩坑时录的十秒屏幕录像。读者不用跳转，眼睛往右一瞥就能对上号。这种设计思路其实很老派——纸书页边的批注就是这么干的。只不过纸书批注是读者写的，网站旁注是作者预埋的。

我注意到一个细节：那些旁注做得好的站点，正文往往写得更狠。因为作者知道旁边有地方兜底，正文就敢砍掉解释性段落，只留主干。像某个讲CSS Grid的页面，正文就一句话加一张图，旁注里却分了四块：浏览器兼容表、一个可拖拽的示例、两段MDN摘录、还有作者自己录的语音说明。正文成了索引，旁注成了仓库。这种分工挺聪明的，但前提是旁注得真的有人看。数据上，旁注的点击率通常不到正文链接的三分之一。所以多数站点还是把旁注当垃圾桶，塞广告、塞推荐、塞“关注我的推特”。

去年帮朋友改一个文档站，我干了一件事：把旁注里所有“相关阅读”删了，换成正文里每个专业术语的即时解释。鼠标悬停就浮出来，移开就消失。上线两周，页面停留时间涨了四十秒。朋友说读者反馈“读起来不卡了”。其实卡不卡跟网速没关系，是认知上的卡——正文里蹦出一个没见过的词，读者要么忍住继续读，要么开新标签页去搜。旁注把搜这一步省了。这跟纸书脚注的逻辑一模一样，只是网页能做得更轻。

不过旁注有个天然缺陷：窄。三百像素宽的地方，放代码要折行，放表格要横滚，放图片得缩到看不清。所以真正好用的旁注往往很克制——只放短句、短代码、短链接。我见过一个反例，有人把整个GitHub issue的讨论串嵌进旁注，结果页面右边比左边长三倍，滚轮滑半天回不到正文。旁注是配角，抢戏就完了。

现在我自己写东西，会先问一句：这段解释放正文里会不会打断节奏？会，就扔旁注。旁注不是第二正文，是正文的呼吸孔。没有它，正文憋得慌；塞太满，读者喘不过气。那个度，得自己试。