html注释必须用包裹,漏掉感叹号或在注释中出现--或>会导致提前终止;禁止嵌套、标签内或doctype前使用,敏感信息不可藏于注释中。

HTML注释必须用 <!-- 和 --> 包裹
浏览器只认以 <!-- 开头、--> 结尾的文本为注释,其他写法(比如 // 或 /* */)在 HTML 主体里完全无效,会被当成普通文字直接显示出来。漏掉感叹号(写成 或 <code>)是最常见错误,结果整段“注释”暴露在页面上。
注释里不能出现 -- 或 > 连续字符
HTML 解析器一旦遇到 --> 就立刻终止注释,不管它是不是你本意的结尾。比如写 <!-- 启用--自动保存 -->,实际只注释了 启用,后面 自动保存 --> 全部裸露渲染,甚至可能破坏 DOM 结构。
- 安全替代:用中文破折号
——、en dash–,或加空格隔开- - - 别在注释末尾留空格再跟
>,例如<!-- end -- >有风险 - VS Code 高亮失效、W3C 验证报错,十有八九是这个原因
别在 <script> 或 <style> 里用 HTML 注释语法
<script> 和 <style> 标签内部是 JS/CSS 执行环境,<!-- 在这里不会被识别为注释,反而可能被当作文本字面量的一部分,干扰调试器断点或触发旧版 IE 的兼容逻辑。
- JS 里该用
//或/* */,CSS 里只用/* */ - 编辑器对 JS/CSS 注释有完整高亮和折叠支持,HTML 注释在 script/style 里既无高亮,也易误删
- 错误示例:
<script><!-- 初始化函数 -->function init(){}——<!--会被当成字符串开头
用编辑器快捷键快速增删注释
VS Code、WebStorm 等主流编辑器都支持选中代码后按 Ctrl+/(Windows/Linux)或 Cmd+/(macOS),自动包裹 <!-- 和 -->,再按一次可取消。这个功能比手敲可靠得多,尤其处理多行结构时。
- 选中整段 HTML(含标签和换行),快捷键会生成块级注释,不是每行单独加
<!-- - 不推荐在属性值中间插注释,如
<div class="btn" <!-- 别动 --> data-id="1">—— 语法非法,解析器直接报错 - 注释适合模块分隔(
<!-- header start -->)、临时禁用代码(<!-- <div class="ads"></div> -->)、标记TODO,但别藏 API key 这类敏感信息
最常被忽略的是注释位置的合法性:不能嵌套、不能在标签内部(如 <p>></p>)、不能在 DOCTYPE 前——这些地方看似“没报错”,但 XML 解析器或构建工具(如 html-loader)可能直接失败。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











