HTML 词条目录
前端Wiki/HTML/基础/初识 HTML

注释与书写规范

注释写在 <!-- --> 之间,浏览器不会渲染它们,但任何人查看源代码都能看到。注释常用来解释"为什么这样写"、标注区块边界,或者临时禁用一段代码排查问题。

注释不能嵌套,从第一个 --> 处就结束了,多写一个 -- 都可能让后面的内容暴露出来。条件注释(针对旧版 IE)已是历史,现在不必学习。

团队协作中的书写规范通常包括:标签名与属性名小写、属性值用双引号、层级缩进两个空格、每个元素独占一行。规范不改变运行结果,但直接决定代码的可读性和维护成本。

本节要点注释语法是 <!-- 内容 -->,不能嵌套;日常书写坚持小写、双引号、统一缩进,让代码风格稳定可读。
HTML
<!-- 区块注释:说明这一段是导航 -->
<nav>
  <a href="/">首页</a>
  <a href="/docs">文档</a>
</nav>

<!-- 临时隐藏一段代码排查问题,提交前记得清理 -->
<!-- <div class="banner">活动横幅</div> -->

<!-- 错误示范:注释不能嵌套,第二个 --> 后面的内容会暴露出来 -->
<!-- <!-- 嵌套注释 --> 这样写是错的 -->
🔗 相关词条浏览器标签元素HTML