前端开发代码注释的作用及使用示范-木庄网络博客

本文摘自PHP中文网，作者yulia，侵删。

我们在编写页面的时候，注释是必不可少的一部分，注释一方面可以让自己看清代码的结构，找起来更方便，另一方面，也有利于同事之间的工作交接，当然代码注释也要规范使用。那么今天就和大家聊聊前端代码的注释吧，有需要的朋友可以参考一下，希望对你有所帮助。

一、代码注释有什么用

1、和伪代码一样的作用，为接下来要实现的功能写出一个指导性的算法思路。只是没有伪代码详细。但是也指出了完成此功能的大体算法思路。
2、给看代码的人一个解释性说明。注意看代码的人包括你自己。让看你代码的人可以快速的浏览你的代码，不至于每看一行都要一行一行的看下去，才能明白你写的什么。

二、代码注释规范，遵循以下原则

1、能够帮助读者更好的了解代码逻辑与结构
2、特别的或不容易理解的写法可以解释说明
3、特殊标记注释：如 TODO、FIXME 等有特殊含义的标记
4、文件注释：部分规定会要求在文件头部书写固定格式的注释，如注明作者、协议等信息
5、文档类注释：部分规定要求 API类、函数等使用文档类注释（如 jsdoc 风格）
6、遵循统一的风格规范，如一定的空格、空行，以保证注释自身的可读性

三、代码注释怎么写

1、HTML代码注释：;

<!-- html中要注释的内容 -->
在web页面中，最常见的注释就是这种了。我们在布局页面结构的时候，会添加少许的注释方便我们查找与记忆我们的想法。
那么在页面中除了这样的注释外，还有那些注释呢，这里我列举一些：
If条件不同版本浏览器注释列表：
<!--[if !IE]>除IE外都可识别<![endif]-->
<!--[if IE]> 所有的IE可识别 <![endif]-->
<!--[if gt IE 5.0]> IE5.0以及IE5.0以上版本都可以识别 <![endif]-->
<!--[if IE 6]> 仅IE6可识别 <![endif]-->
<!--[if lt IE 6]> IE6以及IE6以下版本可识别 <![endif]-->
<!--[if gte IE 6]> IE6以及IE6以上版本可识别 <![endif]-->
<!--[if IE 7]> 仅IE7可识别 <![endif]-->
<!--[if lt IE 7]> IE7以及IE7以下版本可识别 <![endif]-->
<!--[if gte IE 7]> IE7以及IE7以上版本可识别 <![endif]-->