语义化规范需工程化落地：CI/CD集成htmlhint强制校验、VS Code插件实时标错、正误对照文档、Code Review硬性检查三项、PR须附DevTools截图、新人首日跑通验证链并使用带注释模板。

靠个人自觉很难落地，必须把语义规范变成可检测、可拦截、可反馈的工程环节。

用工具把规则固化进开发流程

在 CI/CD 流程中集成 htmlhint，强制校验关键项：比如 id-unique（禁止多个

）、headings（标题不能跳级）、attr-req-alt（ 必须有 alt）。本地开发时，VS Code 安装 HTMLHint 插件，保存即标红错误，问题不过夜。

写清楚“什么能做、什么不能做”

文档不讲抽象原则，只列具体正误对照：

• ❌ 错误：
• ✅ 正确：
  • @#@#@#@#@#@#@#@#@#@0
• ❌ 错误：

  这是简介

  

  DeepBI DHTML 页面生成器

  生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur

  下载
  （无标题）
• ✅ 正确：

  关于我们

  这是简介

Code Review 设定硬性检查项

每次 PR 合并前，必须人工确认三项：

• 页面是否只有一个

• 是否缺失
  或出现多个
• 是否有 被
  替代

  PR 描述里禁止写“已语义化”，必须附 DevTools 中 Elements 面板截图，高亮对比前后结构差异。

  新人第一天就要跑通验证链

  入职配置完本地环境后，第一件事是运行构建命令，触发 htmlhint 报错。看到红色提示才允许提交代码。配套提供一份带注释的最小可运行模板，包含正确嵌套的

  、

  、

  、

  、

  ，所有标签都带真实内容和必要子元素（如

  内含

  ，

  带

  ）。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！