<p>HTML中可用语义化注释标记区块边界，如<!-- nav start -->与<!-- nav end -->，需用模块名+状态+时间戳、分段独立书写，并避免-->>截断及无意义冗余。</p>
用 <!-- 和 --> 包裹区域起止标识
HTML 里没有“命名区域”或“书签式跳转”机制，但开发者普遍用带语义的注释来标记关键区块。比如在 <header> 前加 <!-- header 开始 -->，在闭合标签后加 <!-- header 结束 -->。这类注释不参与渲染，但能被编辑器（如 VS Code）的「查找」功能快速定位，也方便团队成员一眼识别结构边界。
避免模糊描述，用具体模块名+状态+时间戳
写 <!-- 导航栏 --> 不如写 <!-- nav: 主导航（含搜索框，2026-05-08 已接入新菜单 API） -->。原因有三：一是模块名（nav）比中文更易全局搜索；二是括号内说明当前状态和变更依据，避免多人协作时误判；三是时间戳让后续回溯有据可查。别写“旧版”“临时”，这些词半年后就失效。
多行结构注释要分行写，不堆成一块
面对大段嵌套结构，不要把整个模块塞进一个注释块里。错误示例：<!-- main-content: 包含 sidebar、article、pagination... -->。正确做法是分段独立注释：
<!-- main-content 开始 --> <main class="main-content"> <aside class="sidebar"></aside> <article class="article"></article> <nav class="pagination"></nav> </main> <!-- main-content 结束 -->
这样每段都能单独启用/禁用，也方便 Git diff 显示清晰变更点。
立即学习“前端免费学习笔记（深入）”；
注意注释内容里的 -- 和 > 会提前截断
HTML 解析器遇到第一个 --> 就结束注释，所以注释正文里不能出现连续两个短横加右尖括号。例如 <!-- 这里有--符号 --> 实际只注释到“有”，后面“符号 -->”会被当作 HTML 解析，可能破坏结构。遇到这类情况，改用全角符号或拆分描述，比如写成 <!-- 这里有 —— 符号 --> 或 <!-- 此处含双短横 -->。
真正容易被忽略的是：注释本身也是 DOM 构造的一部分——虽然不显示，但在浏览器源码视图和某些自动化工具（如 Lighthouse 的结构分析）中仍可见。如果大量使用无意义注释（如“这里开始”“这里结束”重复几十次），会影响代码体积和可读性，不如精简为关键节点标记。
