HTML5注释只有一种语法，无临时与正式之分；开发中可用但须提交前清理，避免污染生产环境、触发CI告警或误导团队；推荐用JS注释+环境变量替代，并确保HTML临时注释含责任人、原因及清理时限。

HTML5 注释语法本身没有“临时”或“正式”之分

HTML5 只有一种注释语法：，它不区分用途，浏览器会完全忽略其中内容。所谓“临时备注”，其实是开发者在写代码时的主观行为，不是语言特性。关键在于怎么用、何时删、如何避免干扰协作和构建流程。

临时注释别塞进生产 HTML 文件里

很多团队误把 这类标记留在上线页面中，这会带来几个实际问题：

• 增加 HTML 体积（尤其大量遗留注释时）
• 被爬虫或自动化工具意外抓取并索引（虽不渲染，但可读）
• CI/CD 流程中触发 HTML 静态检查告警（如 html-validate 默认警告非空注释）
• 新成员误以为是“待办事项”，却找不到上下文或责任人

实操建议：

• 开发阶段可用，但提交前用编辑器快捷键（如 VS Code 的 Ctrl+Shift+P → “Remove All HTML Comments”）批量清理
• 用 git diff 检查是否残留 类标记
• CI 脚本中加入 grep -q '
  ...

  常见失效写法：

  • → 没人知道“later”是哪天，“fix”指什么
  • → 搜索不到含义，也搜不到人
  • → 构建后还在，测试完没删，变成幽灵注释

  复杂点在于：HTML 注释无法被 lint 工具自动追踪生命周期。一旦写了，就得靠人盯、靠流程卡、靠 Git 提交信息反查。没人跟进的话，三个月后它就成谜题了。