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

直接用 包住你想说明或临时屏蔽的内容,浏览器完全忽略它,但编辑器里清晰可见——这是唯一合法、通用、安全的 HTML 注释方式。
注释必须用 ,不能嵌套也不能混用其他语法
HTML 没有单行/多行之分, 之间所有内容(含换行)都算一个注释块。常见错误包括:
-
-->:内层-->会提前关闭外层注释,后续内容裸露甚至解析失败 -
:中间的--会让注释在“启用”后就终止,后面文字变成明文 - 在
<script></script>或标签内部写>是非法语法,解析器直接报错 - 不能插在属性值里,例如:
会导致
alt值被截断 - 不能用于条件逻辑,像
,中间行没闭合标记——如果选中的是跨标签结构(比如从到),必须手动确认是否真包住了全部 - 模板引擎输出的内容(如 Vue 的
{{ item.name }})若含--或>,快捷键生成的注释大概率提前断裂,建议先转义或改用 JS 控制显隐 - 注释大段代码时,手敲
反而更可靠,尤其涉及缩进对齐时
团队协作中最容易被忽略的其实是注释的“时效性”
没人会特意删掉过期注释,结果上线后页面源码里还挂着“”或者“”。这类注释比没注释更危险——它让你误以为某段逻辑还在生效,其实早已失效或被绕过。真正该做的,是在提交前用 git grep -n "TODO\|FIXME" 扫一遍,确保每条都带截止日期或关联 issue 编号。










