HTML注释唯一合法方式是,不可嵌套、不可混用;禁止出现在DOCTYPE前、标签内、属性值中;快捷键注释需手动验证完整性;过期注释比无注释更危险。

直接用 <!-- --> 包住你想说明或临时屏蔽的内容,浏览器完全忽略它,但编辑器里清晰可见——这是唯一合法、通用、安全的 HTML 注释方式。
注释必须用 <!-- -->,不能嵌套也不能混用其他语法
HTML 没有单行/多行之分,<!-- 到 --> 之间所有内容(含换行)都算一个注释块。常见错误包括:
-
<!-- 外层 <!-- 内层 --> -->:内层-->会提前关闭外层注释,后续内容裸露甚至解析失败 -
<!-- 配置启用--自动保存 -->:中间的--会让注释在“启用”后就终止,后面文字变成明文 - 在
<script></script>或<style></style>标签内部写<!--:现代浏览器虽能容错,但可能干扰语法高亮和调试工具识别
注释位置错了等于删代码,这些地方绝对不能写
注释不是万能胶,放错位置会直接破坏 HTML 结构:
- 不能出现在
<!DOCTYPE html>前面(BOM 后紧接注释可能触发旧版 IE 怪异模式) - 不能写在开始标签内部,例如:
<div class="header" <!-- 顶部区域 -->>是非法语法,解析器直接报错 - 不能插在属性值里,例如:
<img src="a.jpg" alt="<!-- 图片说明 -->test">会导致alt值被截断 - 不能用于条件逻辑,像
<!--[if IE]>这类条件注释已彻底废弃,现代浏览器完全不识别
VS Code 快捷键能提速,但别全信自动包裹
选中多行按 Ctrl+/(Windows/Linux)或 Cmd+/(Mac)确实快,但要注意:
- 它只在首行加
<!--、末行加-->,中间行没闭合标记——如果选中的是跨标签结构(比如从<header></header>到),必须手动确认是否真包住了全部 - 模板引擎输出的内容(如 Vue 的
{{ item.name }})若含--或>,快捷键生成的注释大概率提前断裂,建议先转义或改用 JS 控制显隐 - 注释大段代码时,手敲
<!--+ 换行 + 代码 + 换行 +-->反而更可靠,尤其涉及缩进对齐时
团队协作中最容易被忽略的其实是注释的“时效性”
没人会特意删掉过期注释,结果上线后页面源码里还挂着“<!-- TODO: 替换为真实 API 地址 -->”或者“<!-- 2024 年 Q3 临时方案,待重构 -->”。这类注释比没注释更危险——它让你误以为某段逻辑还在生效,其实早已失效或被绕过。真正该做的,是在提交前用 git grep -n "TODO\|FIXME" 扫一遍,确保每条都带截止日期或关联 issue 编号。

















