html中说明性文本应使用注释，浏览器完全忽略且不影响dom、样式或脚本；不可用display:none或aria-hidden等隐藏方式替代。
HTML 中的说明性文本该用 <!-- --> 还是其他方式？
网页中添加仅供开发者查看、不渲染到页面上的说明性文本，唯一标准且安全的方式就是使用 HTML 注释：<!-- 这里是注释 -->。浏览器会完全忽略它，不影响 DOM 结构、样式或脚本执行。别试图用 <span style="display:none"></span> 或 aria-hidden="true" 包裹“说明”，那不是注释，而是隐藏内容——它仍存在于 DOM 中，可能被爬虫读取、影响可访问性，甚至意外被 CSS 或 JS 激活。
哪些地方能放心写 <!-- --> 注释？
只要在 HTML 文档主体内（ 标签下、合法标签之间），都可以插入注释。常见且合理的使用场景包括：
html-to-pptx-converter
下载
使用 PptxGenJS 和 Python 解析，将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint（.pptx）演示文稿。
-
<!-- 临时禁用某段代码，便于调试 -->，比如把<header>...</header>整块包起来 -
<!-- 组件 A 的起始位置 -->和<!-- 组件 A 的结束位置 -->，辅助快速定位结构 -
<!-- @author zhangsan @date 2024-05-20 -->，记录维护信息（注意：不要放敏感信息，如 API key、内部路径） - 在
<script></script>或<style></style>标签内部——不能用//或/* */，因为它们属于 JS/CSS 语法；HTML 解析器只认<!-- -->作为注释边界
<!-- --> 注释的三个易错点
看似简单，但实际协作中常因细节翻车：
- 注释不能嵌套：
<!-- 外层 <!-- 内层 --> 后半截会暴露为明文 -->→ 浏览器只识别第一个-->为结束，后面全变可见文本 - 注释内不能出现
--连续字符（哪怕在字符串里）：<!-- 这里有--破折号 -->会报解析错误，应写成<!-- 这里有—破折号 -->（用 en dash）或绕开 - 服务器端模板（如 EJS、Django）若本身也用
<!-- -->作注释，需确认是否被双重解析——例如 EJS 的<!-- <% if (x) { %> -->可能提前截断，此时应改用模板引擎专属注释语法（如）
要不要把注释发到生产环境？
可以，但得权衡。HTML 注释不消耗运行时资源，但会增加传输体积、暴露项目结构或历史线索。如果团队有自动化构建流程，建议用构建工具（如 Webpack 的 html-webpack-plugin 配合 minify.removeComments）在生产打包时移除所有 <!-- -->。手动删容易遗漏，而保留全部又可能让竞品或恶意者快速摸清你用的框架版本、模块划分逻辑。
