Nuxt 3 静态站点配置咨询：如何实现类似Nuxt 2.x的通用服务器适配导出（根目录含index.html）

我刚好也折腾过Nuxt3从serverless转静态部署的需求，给你捋清楚怎么配置才能得到像Nuxt2那样的常规静态站点，根目录直接有index.html：

核心配置调整 #

首先要把你当前的Lambda预设替换成静态导出预设，同时对应Nuxt2里的ssr: false和target: 'static'，修改你的nuxt.config.ts如下：

// nuxt.config.ts
import { defineNuxtConfig } from 'nuxt3'

export default defineNuxtConfig({
  // 关闭SSR，对应Nuxt2的ssr: false（如果需要预渲染SSR页面可以设为true）
  ssr: false,
  // 配置Nitro为静态导出预设，对应Nuxt2的target: 'static'
  nitro: {
    preset: 'static'
  },
  // 你原来的head配置完全保留，不用修改
  head: {
    title: 'Title',
    meta: [
      { charset: 'utf-8' },
      { name: 'viewport', content: 'width=device-width, initial-scale=1' }
    ],
    link: [
      { rel: 'icon', type: 'image/png', href: '/favicon.png' }
    ],
    script: [
      { type: 'text/javascript', src: '/mana.js' }
    ]
  },
})

生成静态文件的命令 #

配置好后，执行以下命令生成静态资源：

npm run generate

执行完成后，静态文件会生成在.output/public目录下，这个目录里就包含了你需要的index.html，以及所有静态资源（CSS、JS、图片等）。部署的时候直接把这个目录下的所有文件上传到通用服务器的根目录即可。

关键说明 #

• 你之前用的lambda预设是专门针对AWS Lambda的Serverless部署方案，生成的是适合函数计算的代码结构，不是常规静态站点，所以必须替换成static预设。
• 如果需要保留SSR预渲染（也就是把动态页面提前生成静态HTML），可以把ssr设为true，执行npm run generate时会自动预渲染所有页面生成静态文件，同样适配通用服务器。
• 如果你的站点有动态路由（比如/posts/[id]），需要在nuxt.config.ts里配置generate.routes指定要预渲染的路由，或者开启nitro.fallback: true生成一个404 fallback页面（适配SPA模式的动态路由）。

内容的提问来源于stack exchange，提问作者Lucas