HTML注释只能用包裹且不可嵌套,必须闭合;禁止出现在标签属性内、script/style块中;不用于保密,仅作说明、模块标记或TODO提示。

HTML 注释只能用 包裹,没有其他合法形式;写错位置、嵌套或含非法字符会直接破坏解析。
注释必须闭合且不能嵌套
浏览器遇到第一个 --> 就终止注释,不管后面还有没有未闭合的 外层 --> 会导致“内层 -->”之后的内容全部裸露渲染。
- 错误示例:
-->→ 实际只注释了“导航开始 id="top"> 这种写法语法非法,HTML 解析器会报错或跳过整个标签。注释可以放在标签前后、标签之间,但不能插在开始标签的属性序列中。- 允许的位置:标签前
、标签后、元素之间A
- 不推荐但能解析的位置:在开始标签右尖括号前加空格再写注释(如 ),但会降低可读性,且部分 Linter 工具会警告
- 绝对禁止:属性值中间、
src或href等属性内、<script></script>或标签内部用 HTML 注释脚本和样式块必须用各自语言的注释
在
<script></script>或标签内混用是为兼容极旧浏览器设计的 hack,现代项目无需使用注释不是保密手段,也不该藏敏感信息
所有 HTML 注释都会随源码一起下发到浏览器,用户右键“查看页面源代码”就能看到。把 API Key、路径、内部接口地址写进注释等于公开暴露。
- 常见误用:
→ 立即删除 - 真正需要隐藏的内容,应在服务端处理,前端只接收必要数据
- 注释适合写用途说明、模块边界、TODO 或条件分支提示(如
),但要避免冗长模糊
最容易被忽略的是注释里的
--和>组合——哪怕出现在中文破折号“——”里,某些解析器也会误判为结束符。写说明时优先用全角符号或换词替代,比事后排查渲染异常更省事。 - 绝对禁止:属性值中间、
- 允许的位置:标签前
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










