HTML5中警告性注释需用FIXME、WARNING、TODO等前缀，如，确保可被工具识别、搜索和跳转，避免模糊描述，须明确影响范围与修复指引。
HTML5里怎么写带警告性质的注释
HTML5本身不支持语义化警告注释语法，所有注释都只是<!-- ... -->，浏览器和工具不会解析其中含义。所谓“警告信息”，完全靠人眼识别，必须靠约定俗成的格式让后续维护者一眼看出这是需要警惕的地方。
用TODO、FIXME、WARNING开头的注释最有效
这类前缀是前端团队广泛接受的信号词，构建工具（如ESLint配合HTML插件）、编辑器（VS Code高亮TODO）、甚至Git提交扫描都能识别。重点不是“写得漂亮”，而是“能被搜到、能被跳转”。
-
FIXME：表示这里逻辑有缺陷，但暂时绕过，比如<!-- FIXME: Safari下flex gap失效，临时用margin模拟 --> -
WARNING：提示潜在风险，比如<!-- WARNING: 此div被JS强依赖id='user-panel'，重命名需同步改script --> -
TODO：明确待办，比如<!-- TODO: 待接入SSR，移除此内联script -->
避免写成“自说自话型”注释
很多注释失败是因为只写了“为什么当时这么写”，却没告诉别人“现在该怎么处理”。维护者看到<!-- 这里加了10px margin因为设计师说要留空 -->毫无行动指引；而<!-- WARNING: margin值硬编码，响应式断点未适配，修改前请同步检查@media (max-width: 768px) -->才真正有用。
- 别只写原因，要写影响范围（如“影响登录页所有按钮”）
- 别写模糊表述，如“可能有问题”，改成“Chrome 122+ 触发document.hidden误判”
- 路径、ID、函数名等关键标识符必须用
标签包裹，方便搜索定位
配合编辑器和工具提升可见性
单靠人工阅读注释效率极低。把FIXME类注释变成可交互线索，才是关键。
立即学习“前端免费学习笔记（深入）”；
- VS Code默认高亮
TODO/FIXME，无需插件；想高亮WARNING，可在settings.json中加"todo-tree.regex.regex": "(//|#|
