在html中添加注释的方法是以<!--开头，以-->结尾。1. 注释内容不会被浏览器执行，可用于标记代码块、临时屏蔽代码或团队协作说明；2. 使用时需注意不能嵌套注释、避免连续两个减号、保持简洁清晰；3. 配合代码缩进并确保注释准确，有助于提升代码可读性和维护效率。

在HTML中添加注释其实很简单，但很多人刚开始写代码时不太注意这个细节。其实合理使用注释不仅能帮助自己理清结构，也方便别人阅读你的代码。下面我们就来看看HTML注释的基本写法和一些实用技巧。

---

注释的基本语法

HTML中的注释是以 <!-- 开头，以 --> 结尾的。在这两者之间的内容都会被浏览器忽略，不会显示在页面上，也不会影响页面运行。

比如这样：

立即学习“前端免费学习笔记（深入）”；

<!-- 这是一个简单的注释 -->

你也可以跨行写注释：

<!-- 
  这是一段多行注释，
  可以用来说明比较复杂的结构或模块。
-->

需要注意的是：

html-deploy

使用 htmlcode.fun 将 HTML 内容或文件部署到网页，适用于用户要求“部署到网页”“托管此 HTML”“生成此前端...的实时链接”等场景。

下载

• 注释不能嵌套（也就是说不能在一个注释里再写一个完整的注释）
• 注释内容不要包含连续两个减号 --，否则会提前结束

---

常见用途与使用场景

HTML注释最常见的用途有几种：

• 标记代码块：比如把一段导航栏、页脚等内容用注释标明，便于快速定位。

  <!-- 导航栏开始 -->
  <nav>...</nav>
  <!-- 导航栏结束 -->

• 临时屏蔽代码：调试或修改页面时，不想删除某部分代码，可以先注释掉。

  <!-- 
    <div class="old-section">
      这部分内容暂时不需要显示
    </div>
  -->

• 团队协作说明：多人开发时，可以在关键位置加上注释说明意图或待办事项。

  <!-- TODO: 这里需要替换成动态数据 -->

这些做法虽然简单，但在实际开发中非常有用，尤其在维护老项目或者交接代码的时候。

---

使用注释的一些小技巧

1. 保持简洁清晰：注释不是越长越好，只要能说明问题就行。太啰嗦反而影响阅读。
2. 避免重复信息：比如标签本身已经很清楚了，就不用再加“这是标题”之类的注释。
3. 配合代码结构缩进：注释的位置和缩进尽量和对应的代码对齐，看起来更整洁。
4. 不要提交错误注释：写完代码后记得检查注释是否还准确，过时的注释比没有还糟糕。

---

基本上就这些。HTML注释虽然不难，但用得好确实能让代码更易读、更专业。写代码不只是让机器看懂，更重要的是让人也能轻松理解。