html静态化本身不提升页面质量，只提升性能和可缓存性；真正影响页面质量的是静态化过程中是否保留语义结构、可访问性标记和正确渲染逻辑。
HTML静态化本身不提升“页面质量”，它只提升性能和可缓存性；真正影响页面质量的是静态化过程中是否保留语义结构、可访问性标记和正确渲染逻辑。
HTML静态化 ≠ 丢掉语义和可访问性
很多团队把动态页“dump成HTML”就完事，结果生成的 index.html 里全是 <div class="box"> 堆砌，<code><header></header>、<nav></nav>、<main></main> 全被替换成 <div>。搜索引擎抓取不到结构，屏幕阅读器无法导航，SEO 和无障碍直接掉档。
<ul>
<li>模板渲染阶段必须保留 HTML5 语义标签，不能靠 JS 后置补 —— 静态文件是最终交付物，没有 JS 执行环境</li>
<li>所有 <code>alt、aria-label、lang 属性必须在模板中动态注入，不能留空或硬编码占位符
document.createElement 补结构），那说明模板层就有缺陷静态化后 CSS/JS 路径失效的典型场景
本地开发时路径写成 ./css/style.css，静态化后文件输出到 /var/www/static/home/index.html，但 CSS 实际放在 /static/css/style.css —— 浏览器加载 404，页面白屏或无样式。
- 模板中所有资源路径必须用绝对路径（以
/开头）或根相对路径（/css/style.css），禁用./或../ - Django 的
{% static 'css/style.css' %}、Vue 的@/assets别名，在静态化前必须被真实解析成可部署路径 - 检查生成的 HTML 源码，确认
<link href="...">和<script src="..."></script>的 URL 能被 Nginx/Apache 直接命中
更新触发时机错配导致内容陈旧
商品详情页静态化后，后台改了价格，但静态文件没重生成；用户看到的还是旧价 —— 这不是缓存问题，是静态化流程漏掉了数据变更通知。
- 不要只依赖定时任务（如每小时跑一次
gen_detail_html.py），对高时效性内容必须监听数据库变更（如 MySQL binlog 或 Django signal） - 静态文件命名建议带版本或哈希（如
product_123_v20260630.html），避免 CDN 缓存覆盖问题 - 生成失败时要有明确日志（如
Failed to render template detail.html for product_id=456），不能静默跳过
最常被忽略的一点：静态化后的页面如果含异步请求（比如用 axios 加载评论），这些请求的 endpoint 必须仍由后端提供，不能指望“全静态”就删掉 API —— 静态化只解决首屏结构，交互逻辑该走哪还走哪。
