HTML5无废弃代码专用注释语法，仅作人工提示；应明确标注DEPRECATED/OBSOLETE、具体标签名及CSS或语义化替代方案，但注释不阻止渲染，真正有效的是删除废弃标签并验证。
HTML5 中没有专门用于标记“废弃代码”的注释语法， 本身只是普通注释，浏览器完全忽略，也不会触发任何警告或提示。所谓“废弃标记的注释写法”，其实是开发者约定俗成的自我提醒手段，不是标准功能。
HTML 注释里怎么标出过时代码
直接在 内写明废弃原因和替代方案，重点是让后续维护者（包括未来的你）一眼看懂“为什么不能留”“该换成什么”。
- 用明确动词：写
DEPRECATED、OBSOLETE或REMOVED IN HTML5，别只写“旧版” - 带上具体标签名：比如
、，避免模糊指代 - 给出迁移路径：注明推荐的替代方式，例如 “请改用 CSS
text-align” 或 “用替代”Hello
为什么不能靠注释自动检测废弃标签
浏览器解析 HTML 时，
内容彻底不参与 DOM 构建，也不触发任何校验逻辑。即使你写，标签依然会被渲染——注释对它毫无约束力。- HTML5 验证器（如 W3C Validator）只检查实际出现的标签，不会扫描注释内容
- IDE 或 Linter（如 VS Code + HTMLHint）默认也不解析注释语义，除非你额外配置自定义规则
- 真正起作用的是“删掉注释里的废弃标签”，而不是“注释它”
更有效的废弃代码处理流程
注释只是过渡手段，关键动作是识别、替换、验证。把注释当作待办清单，不是归档终点。
立即学习“前端免费学习笔记（深入）”；
- 用浏览器开发者工具的
Elements面板手动搜索、、 - 运行命令行工具快速定位：
grep -r " - 替换后务必检查视觉表现：CSS 替代方案可能因继承或优先级导致样式偏移
- 上线前用 W3C HTML Checker 验证，它会直接报出
这类废弃标签的使用错误
注释写得再详细，也掩盖不了没删掉的
