HTML注释被浏览器完全忽略,语法为且不可嵌套;错误用法包括含--、置于DOCTYPE前、混入script/style内;影响文件体积和SEO文本密度;应注释意图而非显见结构,注意构建工具可能移除及过期风险。

HTML 注释不会影响页面运行,浏览器会完全忽略 中的内容,既不解析、也不渲染、更不执行。
HTML 注释的语法和位置限制
标准 HTML 注释必须用 结尾,且不能嵌套。常见错误包括:
- 在注释中使用
--(如)会导致解析中断,后续内容可能被意外注释或报错 - 把注释写在
前面(XML 或 XHTML 场景下可能触发 quirks mode) - 在
或标签内部混用 HTML 注释(现代 JS/CSS 不需要,且可能干扰语法高亮或工具解析)
注释对加载性能和 SEO 有影响吗
注释本身不参与 DOM 构建,但会影响 HTML 文件体积:
- 大量无意义注释(如整段废弃代码、重复说明)会增大传输体积,拖慢首字节时间(TTFB)和解析速度
- 搜索引擎不读取注释,但过度注释可能稀释页面有效文本密度(虽影响极小,SEO 工具有时会警告)
- 服务端压缩(如 gzip)能缓解体积问题,但别依赖它来掩盖冗余注释
哪些地方适合加注释,哪些不该加
注释的价值在于“解释意图”,而非“描述显而易见的结构”:
立即学习“前端免费学习笔记(深入)”;
- ✅ 推荐:标记组件边界(
)、说明 hack 原因()、临时禁用某段逻辑 - ❌ 避免:给每个 加
、重复标签名()、用注释替代语义化标签- ⚠️ 注意:构建工具(如 Webpack + HTMLWebpackPlugin)可能默认移除注释,生产环境看不到你写的说明
真正容易被忽略的是注释的“生命周期”——上线后没人维护,过期注释比没注释更危险,尤其当它暗示某个 bug 已修复,其实还存在。










