html中可用语义化注释标记区块边界，如与，需用模块名+状态+时间戳、分段独立书写，并避免-->>截断及无意义冗余。
用 <!-- 和 --> 包裹区域起止标识
HTML 里没有“命名区域”或“书签式跳转”机制，但开发者普遍用带语义的注释来标记关键区块。比如在 <header></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 的结构分析）中仍可见。如果大量使用无意义注释（如“这里开始”“这里结束”重复几十次），会影响代码体积和可读性，不如精简为关键节点标记。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
