应以终态html为质量锚点，统一接入prettier --parser html格式化与html-validate强检，禁用pug等引擎的美化选项，通过ci卡点校验doctype、lang、charset及语义规范。
多个模板引擎混用时，HTML语义和缩进怎么不打架
不同模板引擎（如Pug、Nunjucks、Handlebars、EJS）对HTML结构的生成逻辑差异很大：Pug默认省略闭合标签、缩进敏感；Nunjucks允许原生HTML混写但会破坏缩进一致性；Handlebars在{{#if}}块内嵌套容易导致层级错乱。这些差异直接让团队统一代码质量变得困难。
关键不是禁止用某种引擎，而是把“输出结果”作为质量锚点——即最终渲染出的HTML必须符合规范，而非源文件。
- 所有模板引擎的构建流程中，必须接入
prettier --parser html对编译后HTML做终态格式化，而不是只格式化源文件 - 在Webpack/Vite插件或构建脚本里加一步：
html-minifier-terser+prettier双校验，确保输出HTML有DOCTYPE、lang、charset且缩进为2空格 - Pug等缩进型引擎需禁用
pretty选项（避免它自己美化），交由Prettier统一处理终态，否则会出现“Pug美化一次、Prettier又美化一次”的嵌套缩进爆炸
模板变量和条件块如何不影响HTML结构合法性
模板语法插入点（如{{header}}、）一旦位置不当，极易产出非法嵌套或断裂标签，比如<div>{{content}}</div>中content若含未闭合<p></p>，终态HTML就失效。
这不是模板引擎的问题，是使用方式没约束。
- 禁止在标签属性值内部插变量：
<div class="{{cls}}">不行，应改用<code><div class="<%= cls %>">（EJS）或<code><div class="{cls}">（JSX风格预处理器），确保引号包裹不被截断 <li>所有条件/循环块必须成对出现且不跨标签边界：不允许<code><div><span>text</span></div>，应封装为独立partial或组件 - 用
htmlhint配置attr-quote-style和spec-char-escape规则，在CI中扫描终态HTML，拦截&未转义、属性缺引号等低级错误 - 对含Shadow DOM的组件，必须在测试环境显式调用
shadowRoot.innerHTML提取内容，喂给axe-core做二次扫描 - 禁止在
<template></template>或<slot></slot>内部写未闭合标签，Prettier无法校验<template></template>里的HTML，需靠ESLint插件eslint-plugin-lit-a11y补位 - 所有自定义元素的
render()方法返回的模板字符串，应通过DOMParser解析并校验结构合法性，CI中加一行脚本跑document.evaluate('//body//*/@alt', doc, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null)查缺失alt - 在
.prettierrc中强制开启"htmlWhitespaceSensitivity": "strict"，避免因空格处理差异导致aria-hidden="true"被意外换行截断 - Git Hooks（Husky）中配置
lint-staged只校验终态HTML（即dist/**/*.html），不校验src/templates/**/*源文件 - CI中运行
html-validate --config .htmlvalidate.json dist/**/*.html，规则必须包含require-lang-attribute、require-doctype、no-inline-style三项强检，失败直接中断发布
Web Components与模板引擎共存时，Shadow DOM内容怎么过语义检查
当项目同时用<my-header></my-header>（Web Component）和Nunjucks渲染页脚时，htmlhint或axe-core默认只扫Light DOM，会漏掉Shadow DOM里的<h2></h2>缺失、alt为空等问题。
这类问题不会报错，但会让可访问性检测失真。
多引擎项目里，谁来定义和执行HTML质量红线
没有统一的“守门人”，质量标准就会退化成各引擎维护者各自的理解。比如Pug组认为img(src=imgUrl alt="")合法，而Nunjucks组坚持alt必须非空——终态HTML在两个地方都存在，但质量水位不一致。
真正起作用的不是文档，是CI流水线里的硬性卡点。
最常被忽略的是：终态HTML校验必须跑在构建产物上，而不是开发时的热更新临时文件。很多团队在本地用Prettier格式化Pug源码就以为万事大吉，结果构建后Nunjucks注入了未转义的&，上线才暴露问题。
