静态生成时动态标签不炸开的关键是生成器必须识别并执行模板语法；htmlhint 通过配置排除或移至 template/script 块规避误报；doctype 和 lang 属性需严格符合规范；语义化标签缺失会导致 seo、无障碍和 js 失效。

静态生成时动态标签怎么不炸开？

静态页面生成过程中，<!--#include-->、<?php echo $title ?>、{{ title }} 这类模板语法如果没被正确处理，就会原样输出到 HTML 文件里，变成肉眼可见的“乱码”或空白——这不是浏览器渲染问题，是生成阶段就失败了。

关键在于：生成器是否识别并执行了这些占位符。比如 StaticHtml 默认只做 HTTP 抓取快照，对服务端 SSI 或 PHP 标签完全无感；而基于 Node 的 html-webpack-plugin + lodash.template 则需要显式配置 loader 才能解析 。

• 确认生成工具链是否支持目标模板引擎（如 EJS、Handlebars、Twig）
• 检查构建脚本中是否漏掉 render() 或 compile() 步骤，仅 copy 了原始模板文件
• 避免在 <script></script> 块内混用双大括号语法（如 {{ data }}），可能被 HTMLHint 当作未闭合标签报错

HTMLHint 怎么不把合法的动态占位符当错误？

HTMLHint 是纯静态分析器，它看到 {{ title }} 就会报 attr-lowercase 或 attr-no-duplication 错误，因为它根本不知道这是模板变量——不是 bug，是设计如此。

解决办法不是关掉规则，而是精准排除：

Wechat HTML Publisher

直接上传HTML富文本到微信公众号草稿箱。支持完整的HTML格式,无需Markdown转换。

下载

• 在 .htmlhintrc 中用 "attr-req-value": false 松动对属性值的强制要求（适用于 data-* 类动态属性）
• 用注释临时禁用：<!-- htmlhint attr-no-duplication: false --><div class="item" attrs> <li>更稳妥的做法：把模板语法统一放在 <code><template></template> 或 <script type="text/template"></script> 块里，HTMLHint 默认跳过这些区域

lang 属性和 DOCTYPE 在静态生成中为什么总出错？

很多静态生成器（如 Hugo、Jekyll）默认注入的 和 <meta charset="UTF-8"> 位置不对，导致 HTMLHint 报 doctype-first 或 charset-req 错误，甚至触发 IE 的怪异模式。

真正起作用的只有两件事：

• 必须是文件开头第一个非空、非注释字符，前面不能有 BOM、空格或 <code><!-- comment -->
• <meta charset="UTF-8"> 必须出现在 前 1024 字节内，且不能被 JS 或 CSS 阻塞（尤其注意某些 CMS 模板里把它放在 <link> 后面）
• lang 属性值必须匹配实际内容语言，lang="zh" 和 lang="zh-CN" 对 SEO 和屏幕阅读器行为影响不同，别硬套默认值

语义化标签在静态生成里最容易被忽略什么？

生成器常把所有区块都塞进 <div class="section">，看起来能跑，但 <code><main></main> 缺失、<header></header> 嵌套在 <article></article> 里、多个 <nav></nav> 并列——这些都不是样式问题，是 DOM 结构失效。

后果比想象中严重：

• 搜索引擎可能降权整个页面，因为无法识别主内容区域
• 屏幕阅读器跳过 <main></main> 直接读 footer，用户根本找不到正文
• document.querySelector('main') 返回 null，JS 逻辑崩掉

检查点很简单：打开生成后的 HTML，在浏览器开发者工具里执行 document.body.querySelectorAll('main, header, nav, footer').length，结果必须 ≥ 4 且每个只出现一次。