HTML注释使用<!--和-->包裹,适用于任意位置的单行或多行说明,禁止嵌套,旧版IE条件注释已废弃,应改用JavaScript特征检测或CSS媒体查询。

如果您在编写HTML代码时希望添加说明性文字,但又不希望这些文字在浏览器中显示,则需要使用HTML注释语法。以下是HTML注释的规范写法与常见应用场景:
一、基本注释语法
HTML注释使用<!-- 和 -->包裹,浏览器会完全忽略其中的内容,既不渲染也不执行。该语法适用于单行或多行注释,是HTML标准中唯一被支持的原生注释方式。
1、在HTML文档任意位置(如head内、body内、标签之间)输入<!-- 开始符号。
2、在<!-- 后输入所需说明文字,例如页面头部导航区域。
立即学习“前端免费学习笔记(深入)”;
3、以-->结束注释,确保前后无空格,即写成<!--页面头部导航区域-->。
4、注释内容中不可包含--或>字符序列,否则会导致解析错误或提前终止注释。
二、多行注释写法
当需要对一段结构或功能模块进行较详细说明时,可采用跨多行的注释形式。HTML本身不区分单行与多行注释,仅依赖起始与结束标记的位置,因此换行符会被原样保留于注释内部,但不影响解析。
1、在需要注释的代码块上方输入<!--。
2、按下回车换行,在新行中输入第一段说明,例如以下为用户登录表单,包含邮箱、密码及提交按钮。
3、继续换行,输入第二段说明,例如注意:密码字段已启用type="password"掩码处理。
4、在最后一行末尾输入-->,完成注释闭合。
三、注释嵌套的禁止写法
HTML标准明确规定注释不可嵌套,即在一个<!-- ... -->内部不能再出现完整的注释标记。若误写嵌套结构,浏览器将仅识别第一个<!--到其后最近的-->之间的内容,后续部分可能被当作普通文本或引发解析异常。
1、避免书写形如<!-- 外层注释 <!-- 内层注释 --> 结束外层 -->的结构。
2、若需临时注释大段含已有注释的代码,应手动删除或替换内部的-->为其他占位符,例如改为-->_TEMP。
3、恢复代码时需同步还原所有占位符,否则仍可能导致解析失败。
四、条件注释的替代方案
旧版IE曾支持形如<!--[if IE]>...<![endif]-->的条件注释,但该语法已被现代浏览器全面废弃。当前实现环境差异化逻辑,应改用JavaScript特征检测或CSS媒体查询等标准方法,而非依赖注释机制。
1、删除所有以<!--[if 开头、>结尾的注释块,例如<!--[if lt IE 9]>...
2、检查注释中是否包含script或style标签,如有,将其移至合法位置并确保可执行。
3、用JavaScript判断用户代理字符串时,应优先检测特性而非浏览器名称,例如检测document.querySelector是否存在而非匹配"MSIE"。
五、编辑器辅助注释技巧
多数现代代码编辑器支持快捷键批量添加或取消注释,但实际插入内容仍须符合HTML注释语法。依赖编辑器自动补全时,需确认其生成的是标准<!-- -->格式,而非其他语言风格的注释符号。
1、在VS Code中选中多行后按Ctrl+/(Windows)或Cmd+/(macOS),将自动添加<!-- 和 -->。
2、Sublime Text中使用Ctrl+Shift+P调出命令面板,输入“Comment”选择“Toggle Comment”,确保HTML语法高亮已启用。
3、确认编辑器设置中未启用“自动插入JS/CSS注释样式”,避免生成// 或 /* */等无效符号。











