<p>HTML5注释仅支持<!-- ... -->语法，纯文本记录，浏览器忽略且不执行；所谓“配置说明注释”是开发者约定，非标准配置方式，易出错且不可靠；应改用JSON文件、<meta>标签或全局JS对象等机器可读方案。</p>
HTML5 注释本身不支持配置参数、变量替换或元数据声明，所谓“配置说明注释”只是开发者约定俗成的文本记录方式，浏览器完全忽略它，也不会被解析执行。
HTML5 标准注释语法必须用 <!-- ... -->
这是唯一合法且跨浏览器兼容的写法。任何其他形式（如 //、/* */、<%-- --%>）在 HTML 文件中都不是标准注释，可能引发解析错误或被当作普通文本渲染。
<!-- 配置说明：首页轮播图自动播放间隔为 5000ms，禁用触摸拖拽 --> <!-- ENV: production | API_BASE_URL: https://api.example.com/v1 --> <!-- DISABLED_FEATURES: analytics, push-notifications -->
- 所有内容必须在
<!--和-->之间，中间不能出现--或> - 换行和缩进可自由使用，但不要嵌套注释（HTML 不支持嵌套注释）
- 避免在
<script>或<style>内部用 HTML 注释包裹代码——应改用对应语言的原生注释
常见误用：把 HTML 注释当配置文件用
有人试图用注释传递构建参数（如 <!-- VERSION: 2.3.1 -->），然后靠构建工具提取。这可行但脆弱：
- 构建脚本需额外解析 HTML 文本，易受格式变动影响（比如多空格、换行、注释位置偏移）
- 无法做语法校验，拼写错误（如
VERISON）不会报错，只会在运行时失效 - IDE 不识别这类“伪配置”，无法提供补全或跳转
- 若 HTML 被压缩（如移除注释），所有配置信息直接丢失
更可靠的替代方案
真要记录配置参数，优先选语义明确、工具友好的方式：
立即学习“前端免费学习笔记（深入）”；
- 将配置抽离到独立 JSON 文件（如
config.json），通过fetch()加载或构建时注入 - 使用
<meta>标签携带机器可读的配置（适合简单键值对）：<meta name="app-config" content='{"theme":"dark","timeout":3000}'> - 在
<script>中声明全局配置对象（注意 XSS 风险，避免直接内联用户数据）：<script>window.APP_CONFIG = { apiHost: "https://api.example.com", debug: false };</script>
注释适合写人话说明，不适合当配置载体。哪怕模板再工整，它也只是文本——不校验、不生效、不保证存在。
