HTML注释只有一种语法，即，天然支持跨行，不存在单行或多行之分；浏览器仅识别首尾标记，中间换行缩进均被忽略，但禁止出现--或-->等触发提前终止的字符。

HTML 注释只有一种语法，没有单行/多行之分

HTML 标准里根本不存在“单行注释”或“多行注释”的语法区分—— 就是唯一合法形式，它天然支持跨行。所谓“单行”，只是你写在一行里；所谓“多行”，只是你在 之间手动换了几行。浏览器只认头尾标记，中间换多少次行、缩进几格，全被忽略。

常见错误现象：

• 以为 // 或 /* */ 能在 HTML 里用 → 实际会原样输出到页面，甚至破坏结构
• 编辑器快捷键（如 VS Code 的 Ctrl+/）对选中多行只包首尾 → 容易漏掉某行，导致部分代码裸露
• 复制粘贴一段带缩进的 HTML 到注释里，末尾忘了补 --> → 后续所有 HTML 都不渲染

注释里不能出现 -- 或 --> 这类组合

HTML 解析器遇到第一个 -- 就会提前结束注释，哪怕后面还有内容。比如 ，实际只注释了 这里，后面的 不能这样写 --> 会作为普通文本显示，还可能触发解析错误。

使用场景限制：

HTML Text Extract

从HTML页面（URL、文件或标准输入）中提取主体内容文本，去除导航、页脚、广告和模板文本。可直接传递给readability_check或其他文本工具。

下载

• 要写“减号”或“破折号”，加空格隔开：写成 - - 或 —（em dash）更安全
• 要包含大于号 >，避免紧贴 -- 出现，例如不要写 -->，可拆成 -- >
• 模板引擎动态插入内容时，先对变量做转义，尤其是 > 和 - 连续出现的情况

哪些位置绝对不能写注释

注释不是万能胶，插错地方等于删代码。最常踩坑的是这几种：

• DOCTYPE 前面放注释 → 某些旧版 IE 直接触发怪异模式
• 标签内部写注释，比如
  > → 语法错误，标签直接失效
• <script></script> 或 标签内部用 包每行，直接把整个结构塞进一对 里。VS Code 等编辑器的“多行注释”快捷键（Shift+Alt+A）就是干这个的。

  但要注意：

  • 确保起始 前也留空格，提升可读性：
  • 如果被注释的代码本身含 -- 或 >，先人工检查或改用 JS 控制 display: none 更稳妥
  • 团队协作时，在注释开头标作用域和日期，比如：

  真正容易被忽略的是：注释内容本身会被所有人看到，包括生产环境的源码查看者。所以别在注释里留测试账号、内部路径或“这里有问题但懒得修”这类话。