Nuxt 3 已于 31 July 2026 结束生命周期
此版本将不再接收错误修复或安全补丁。 升级到 Nuxt 4 或获取 HeroDevs 提供的延长支持

defineRouteRules

源码
在页面级别定义混合渲染的路由规则。

Maschinelle Übersetzung ·0 % geprüft

此功能为实验性功能，要使用它，必须在 nuxt.config 中启用 experimental.inlineRouteRules 选项。

用法

pages/index.vue
<script setup lang="ts">
defineRouteRules({
  prerender: true,
})
</script>

<template>
  <h1>Hello world!</h1>
</template>

将会被转换为：

nuxt.config.ts
export default defineNuxtConfig({
  routeRules: {
    '/': { prerender: true },
  },
})
运行 nuxt build 时，主页将预渲染到 .output/public/index.html 中，并以静态方式提供。

说明

  • 在 ~/pages/foo/bar.vue 中定义的规则将应用于 /foo/bar 请求。
  • 在 ~/pages/foo/[id].vue 中定义的规则将应用于 /foo/** 请求。

如需更精细的控制，例如在页面的 definePageMeta 中使用自定义的 path 或 alias，应直接在 nuxt.config 中设置 routeRules。

详细了解 routeRules。