前言：说说注释到底是啥玩意儿

先说个大白话， HTML注释就是那种在代码里写的东西，浏览器根本看不见，只是给写代码的娃们自己看看。别看它不显示，真的能帮大忙。

1、多人协作时注释可用于传递信息或标记待办事项。

总体来看... 多人一起干活儿的时候，大家的思路不一样，一不小心就会踩到对方的坑。于是有人就会在代码里扔几个之类的标记，让后面的人知道还有事没弄完。这个时候注释就像是团队内部的小纸条，虽然很low，但实在是省事。

2、页面结构比较复杂时用注释标明主要区域有助于快速定位和团队协作。

如果你的网站是那种首页有轮播、 侧边栏、底部版权还有很多层层套套，那真的是一眼望去全是标签。 算是吧... 这个时候在每段大块前面加个、 之类的，就跟给自己贴了路标一样，找起来快多了。

什么时候不要乱写注释？

很多新人喜欢把所有想法都塞进注释里后来啊代码变得像小说一样冗长。其实合理使用才是王道——不是每行代码后面都要跟一段解释，也不是越多越好，我坚信...。

① 避免无意义的重复说明， 比如

这句话根本没提供新信息，只是把显而易见的东西再说一遍， 太水了。 浪费空间，还会让后面的同事觉得你在装逼。

② 注释不要写成“TODO：以后再改”。

累并充实着。 如果你真的忘了改，那就真的永远忘了。最好直接把需要改动的地方标记清楚， 比如这样别人一眼能看到问题所在。

临时屏蔽代码：用注释当“开关”

开发过程中， 有时需要快速验证某段代码的影响，可用注释临时屏蔽内容。比如：

这样可以马上看到没有这段脚本页面会怎样，而不用删掉代码再手动加回来——省时又省力，我给跪了。。

老技术：HTML条件注释

虽然现代开发中已较少使用， 但在兼容旧版IE时HTML条件注释曾是有效手段。

我直接好家伙。 现在大体上已经可以不用管它们了 不过如果你的项目还要支持IE6/7，那还是得留点余地。

实际案例：乱七八糟的注释堆砌

下面是一段“烂到极致”的HTML片段，你可以看看到底什么叫“不要学”。

    
MySite
 
     

    
Welcome!
    
lorem ipsum dolor sit amet...，这是可以说的吗？
    

一下——什么时候该用， 什么时候别用

• 需要沟通：团队合作、交接文档、TODO/FIXME 标记，都可以加注释。
• 结构复杂：大块区域前后加说明，让人快速定位。
• 调试临时：想快速关闭某段功能，用 包住即可。
• 不要滥用：每行代码后面都写一堆文字，只会让人翻车；重复显而易见的信息更是垃圾。
• 兼容老浏览器：If you really need IE6/7 support, use conditional comments.

呃， 这篇文章就这么多啦~ 哈哈，如果你还觉得不够烂，那就自行再添点废话吧！祝编码愉快~ 🤪，切记...