html模板中只允许使用注释，禁用嵌套、禁放于/内、禁含--或-->，否则会导致解析中断、dom错乱甚至页面白屏；注释须说明“为什么”和“动它会怎样”，禁止内联，需与代码同缩进且构建时按类型清理。
HTML模板里只该用<!-- -->这一种注释，写错位置、嵌套、或中间含--或-->，会直接导致解析中断、DOM错乱甚至页面白屏。
HTML模板中哪些注释写法会破坏结构
不是所有看着像注释的写法都安全。浏览器解析器对<!-- -->边界极其敏感，稍有偏差就失效。
-
<!--和-->之间不能出现连续两个短横线（--），比如<!-- 配置开关:--debug -->——解析器在--处立刻终止注释，后面debug -->变成可见文本 - 禁止嵌套：
<!-- <!-- 内层 --> 外层 -->实际只识别到第一个-->，后续内容裸露，常导致<div>标签不闭合<li>不能出现在<code><script></script>或<style></style>标签内部：那里该用//或/* */；写<!--进去会让HTML解析器开始注释，而JS/CSS引擎完全忽略，极易报Uncaught SyntaxError - 不能插在属性值里，例如
<div title="<!-- 错! -->test">——多数浏览器截断属性或解析失败 - 写
<!-- sidebar: only shown on desktop, hidden via .sidebar-mobile-only class -->，比<!-- sidebar -->有用十倍 - 标注依赖：
<!-- requires data-user-id attr on <body> --> - 标清条件逻辑：
<!-- rendered only if user.hasSubscription === true --> - 提示样式约束：
<!-- this div must stay outside .container for full-width bg --> - 高危区域加警告：
<!-- DO NOT REMOVE: tracking pixel wrapper --> - 禁用内联注释：
<div class="card"> <!-- card wrapper -->易错位、难维护、CI工具无法校验<h3>编辑器快捷键为什么有时生成错误注释</h3> <p>VS Code 的 <code>Ctrl+/（Win）或Cmd+/（Mac）只在语言模式为html时插入<!-- -->；若当前是plaintext或javascript模式，它会插//或/* */，结果整段变页面文字。- 写注释前务必看右下角状态栏，确认语言模式是
HTML - 选中多行按一次
Ctrl+/，VS Code 默认只包首尾两行——必须手动检查中间是否每行都被<!--和-->完整包裹 - Sublime Text 需装 Emmet 插件才支持 HTML 注释快捷键；纯手敲易漏
-->，别依赖 Tab 补全 - 临时屏蔽大段代码？宁可剪切到草稿区，也别靠注释兜底——尤其当那段代码本身含
--或<code>>时
上线前要不要删注释，怎么判断
不是所有注释都该删。无意义调试痕迹（如每行都
<!-- TODO: refactor -->）必须清除；但关键结构说明类注释可保留，前提是构建流程已配置自动剔除冗余内容。- 服务端渲染或静态站点生成时，未清理的注释会增大 HTML 体积，拖慢首屏加载
- 某些老旧压缩工具（如部分 HTML minifier）可能误删注释，导致依赖注释的构建逻辑失效（例如 Webpack 的
html-webpack-plugin用注释标记注入点） - CI 流程中建议加一条简单校验：扫描所有
- 写注释前务必看右下角状态栏，确认语言模式是
团队协作时注释要说明什么，而不是什么
模板注释不是自我提醒便签，是给下一个修改者看的上下文。重点不是“这是什么”，而是“为什么这么写”和“动它会怎样”。
