You need to enable JavaScript to run this app. NuxtJS如何生成无任何JavaScript的纯静态HTML页面
优惠活动
大模型
产品
解决方案
定价
更多

NuxtJS如何生成无任何JavaScript的纯静态HTML页面

Nuxt 静态生成完全剥离JS的配置方案

完整可落地配置(Nuxt 2 环境)

直接替换nuxt.config.js的核心配置:

export default {
  // 静态生成模式,无需服务端运行时
  target: 'static',
  render: {
    // 关闭默认脚本注入
    injectScripts: false,
    // 关闭资源预加载/预取相关的脚本提示
    resourceHints: false
  },
  build: {
    // 核心开关:不构建客户端运行时代码,从根源上不生成多余JS chunk
    client: false,
    // 抽离CSS到独立文件,匹配现有Yarn打包流程
    extractCSS: true,
    // 禁用chunk拆分,避免生成无用的拆分JS文件
    optimization: {
      splitChunks: false
    },
    // 不生成客户端运行时manifest文件
    manifest: false
  },
  hooks: {
    // 清空SSR上下文的运行时状态,移除默认的window.__NUXT__内联脚本
    'vue-renderer:ssr:context'(context) {
      context.nuxt = null
    },
    // 最终生成HTML时的兜底清理
    'generate:page'(page) {
      // 移除所有残留的script标签
      page.html = page.html.replace(/<script[\s\S]*?<\/script>/gi, '')
      // 移除所有自动生成的data-*属性
      page.html = page.html.replace(/\s+data-[\w-]+="[^"]*"/gi, '')
    }
  }
}

配置生效逻辑

  • build.client: false 是现有配置缺失的核心项,默认Nuxt会同时构建用于客户端水合的运行时代码,关闭后仅保留服务端渲染所需的Vue核心逻辑,不会生成独立的客户端JS文件
  • 多层开关从构建、渲染、输出三个阶段拦截所有客户端相关代码的注入
  • 兜底钩子保证即使有配置遗漏的残留内容,也会在最终HTML输出时直接清除

注意事项

  • 不要在组件中使用仅在客户端生效的逻辑(如DOM事件绑定、客户端生命周期钩子、响应式交互逻辑),这类逻辑会被构建流程识别为需要客户端运行时,可能触发残留JS生成
  • 组件的复用能力完全不受影响,所有组件的渲染逻辑会在静态生成阶段直接输出为纯静态HTML,无需客户端执行任何逻辑

替代方案

如果上述配置仍无法完全满足零JS需求,说明Nuxt围绕客户端水合的核心设计和纯静态无JS的需求存在本质冲突,可选用更轻量的实现方式:

  • 基于@vue/server-renderer编写极简静态生成脚本,仅复用Vue组件的渲染能力,直接输出纯HTML,无任何内置运行时代码
  • 改用支持组件复用的纯静态生成工具,配合现有CSS打包流程,实现零JS输出

内容的提问来源于stack exchange,提问作者Martin

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 17:24:01