prerender 配置

请参阅 指南 > 预渲染 (SSG) 了解如何预渲染

默认情况下，预渲染是禁用的。要启用它：

// vite.config.js

import { ssr } from 'vite-plugin-ssr/plugin'

export default {
  plugins: [
    ssr({
      // 使用默认的预渲染配置
      prerender: true
      // 与默认的预渲染配置不同：
      prerender: {
        partial?: boolean
        noExtraDir?: boolean
        parallel?: boolean | number
        disableAutoRun?: boolean
      }
    })
  ]
}

partial

可选，默认 false

允许只预渲染一些页面

此设置不会影响预渲染过程：它只是在我们的某些页面无法预渲染时抑制警告

如 指南 > 预渲染 (SSG) 中所述，如果我们不预渲染所有页面，那么我们需要一个生产服务器。通过使用 vite-plugin-vercel，我们仍然可以静态部署我们的预渲染页面，同时为我们的非预渲染页面使用生产服务器。

当页面有一个参数化的路由（例如 Route String /movie /@movieId 或 Route Function) 且没有任何 prerender() hook 提供至少一个与页面路由匹配的 URL（例如 /movie/42） 时，vite-plugin-ssr 会显示无法预渲染的警告

noExtraDir

可选，默认 false

不为每个 HTML 文件创建新目录。

例如，生成 dist/client/about.html 而不是 dist/client/about/index.html

为每个 HTML 文件生成一个目录是告诉静态 host 每个静态 HTML 的静态 URL 的最可靠方式。 但是有些静态 host 更喜欢其他方式

parallel

可选，默认 os.cpus().length

并发预渲染的数量

设置为 false（或 1）以禁用并发

默认值是最快的，但是它可能导致内存使用量激增

在以下情况下禁用并发

• 你遇到 JavaScript heap out of memory 错误
• 如果预渲染花费异常多的时间。 （由于内存开始饱和时启动的内存交换过程非常缓慢）。

disableAutoRun

可选，默认 false

在运行 $ vite build 时禁用预渲染自动启动

如果你想以编程方式启动预渲染，请使用它

请参考 API > prerender() 程序化