HTML页面注释写法详解（实用技巧版）

HTML页面注释的基本格式

在编写网页代码时，为了方便自己或他人理解代码的作用，经常会用到注释。HTML的注释不会在浏览器中显示，只出现在源码里。它的标准写法是用 <!-- 和 --> 包裹内容。

<!-- 这是一个HTML注释 -->

只要在这对符号之间的内容，都会被浏览器忽略，适合作为说明文字。

注释可以跨行

有时候一段结构比较复杂，比如一个导航栏或页脚模块，可以在开始和结束处都加上注释，帮助定位。

<!-- 导航栏开始 -->
<nav>
  <ul>
    <li><a href="/">首页</a></li>
    <li><a href="/about">关于</a></li>
  </ul>
</nav>
<!-- 导航栏结束 -->

这样在后期修改时，一眼就能看出哪部分是什么功能。

注释不能嵌套

需要注意的是，HTML注释不支持嵌套。如果在一个注释内部再写 -->，会导致提前结束。

<!-- 
  这是外层注释
  <!-- 这是内层注释 --> 
  实际上到这里就结束了
-->

上面这段写法是有问题的，第二个 --> 会让注释提前闭合，可能导致后面本该被注释的内容暴露出来，引发错误。

实际使用场景举例

比如你正在做一个简单的个人主页，中间有一块暂时不想删但又不想显示的内容，可以用注释包起来。

<!-- 
<section>
  <h2>正在施工中</h2>
  <p>这部分功能还没做完</p>
</section>
-->

这样既保留了代码，又不会影响页面显示，等以后需要时再拿回来也很方便。

团队协作时，注释更是必不可少。比如你把项目交给同事接手，加几句说明能省去很多沟通成本。

<!-- 轮播图区域，依赖 swiper.js 插件 -->
<div class="swiper-container">...</div>