SSR 选项

ssr.external

• 类型: string[] | true
• 相关: SSR 外部依赖

将给定的依赖项及其传递依赖项外部化以进行 SSR。默认情况下，所有依赖项都被外部化，除了链接依赖项（用于 HMR）。如果您希望外部化链接依赖项，可以将它的名称传递给此选项。

如果为 true，则所有依赖项（包括链接依赖项）都被外部化。

请注意，如果显式列出的依赖项（使用 string[] 类型）也在 ssr.noExternal 中列出（使用任何类型），则显式列出的依赖项将始终优先。

ssr.noExternal

• 类型: string | RegExp | (string | RegExp)[] | true
• 相关: SSR 外部依赖

阻止列出的依赖项被外部化以进行 SSR，它们将在构建中被捆绑。默认情况下，只有链接依赖项不会被外部化（用于 HMR）。如果您希望外部化链接依赖项，可以将它的名称传递给 ssr.external 选项。

如果为 true，则不会外部化任何依赖项。但是，在 ssr.external 中显式列出的依赖项（使用 string[] 类型）可以优先，并且仍然可以被外部化。如果设置了 ssr.target: 'node'，则 Node.js 内置模块也会默认被外部化。

请注意，如果同时配置了 ssr.noExternal: true 和 ssr.external: true，则 ssr.noExternal 优先，并且不会外部化任何依赖项。

ssr.target

• 类型: 'node' | 'webworker'
• 默认: node

SSR 服务器的构建目标。

ssr.resolve.conditions

• 类型: string[]
• 相关: 解析条件

默认为根 resolve.conditions。

这些条件在插件管道中使用，并且只影响 SSR 构建期间未被外部化的依赖项。使用 ssr.resolve.externalConditions 来影响外部化的导入。

ssr.resolve.externalConditions

• 类型: string[]
• 默认: []

在外部化依赖项的 ssr 导入（包括 ssrLoadModule）期间使用的条件。