其实注释很简单，代码就两套写法。HTML里用<!-- 内容 -->，CSS和JavaScript里用/* 内容 */。但简单不等于可以随便写。有人喜欢写“这是头部”，可明眼人一看就知道是头部，注释纯属废话。真正有用的注释，得写“为什么”。比如<!-- 这个导航用flex布局是为了兼容IE11的bug -->，这句话能救后来者一命。

我自己写注释有个习惯，只解释“反直觉”的地方。正常的逻辑，代码自己会说话。但那种用了hack、临时方案、或者业务逻辑特别绕的地方，必须留个说明。去年有个同事改了个轮播图，把自动播放时间从3秒改成5秒，没写注释。三个月后另一个同事接手，以为是bug，又改回3秒。一来一回，两个人都觉得自己在修问题，其实是在给对方挖坑。后来我强制要求：凡是改时间、改数值、改判断条件，一律在注释里写清楚原因和修改日期。

还有一种注释，是给未来的自己看的。你写代码的时候脑子里门儿清，过半年再看，跟看陌生人写的一样。我自己的博客模板，当时为了省事，用了三个嵌套的table布局。现在想改版，打开文件一看，那注释写着“别动这个结构，改了全乱”。我愣是没敢删，老老实实重写了个新文件。这注释不是给别人看的，是给六个月后那个健忘的自己留的后路。

注释写多了也烦。每行都加，页面代码比正文还长，看着就累。我见过最夸张的，一个只有20行的HTML片段，注释写了60行，从设计理念讲到浏览器兼容史。这种注释已经不是便利贴了，是论文。真正好的注释，应该像路标——只在岔路口出现，直道上没必要竖牌子。

有个细节值得注意——注释里的语气。我习惯用“别”“小心”“注意”这种词，带点情绪。有次写<!-- 这个div千万别删，删了首页弹窗就没了 -->，后来真有人想清理冗余代码，看到这句，手就停住了。冷冰冰的“此div用于首页弹窗显示”效果差很多，人下意识会觉得“哦，知道了”，然后继续删。

网页注释不参与渲染，浏览器直接忽略它。但参与“人”的渲染。团队协作时，注释是无声的对话。你写下的每个字，可能成为别人深夜加班时的救命稻草，也可能成为他们咒骂的对象。我宁可多写一句废话，也不愿少写一个关键提醒。毕竟代码错了能改，人要是理解错了，改起来就是大工程。

最后说个真实感受：注释写得好的人，代码通常也不差。因为愿意花时间解释“为什么”的人，说明他思考过“怎么做”之外的东西。这活不涨工资，但能省命。