---
title: "prerenderRoutes"
description: "prerenderRoutes 提示 Nitro 预渲染额外的路由。"
canonical_url: "https://nuxt.zhcndoc.com/docs/3.x/api/utils/prerender-routes"
---
# prerenderRoutes

> prerenderRoutes 提示 Nitro 预渲染额外的路由。

在预渲染时，你可以提示 Nitro 预渲染额外的路径，即使它们的 URL 并未显示在生成页面的 HTML 中。

::important
`prerenderRoutes` 只能在 [Nuxt 上下文](https://nuxt.zhcndoc.com/docs/3.x/guide/going-further/nuxt-app#the-nuxt-context)中调用。
::

::note
`prerenderRoutes` 必须在预渲染期间执行。如果 `prerenderRoutes` 在未预渲染的动态页面/路由中使用，则不会被执行。
::

```ts
const route = useRoute()

prerenderRoutes('/')
prerenderRoutes(['/', '/about'])
```

::note
在浏览器中，或在预渲染之外调用时，`prerenderRoutes` 不会产生任何效果。
::

你甚至可以预渲染 API 路由，这对于完全静态生成的站点（SSG）尤其有用，因为这样你就可以像拥有可用的服务器一样去 `$fetch` 数据！

```ts
prerenderRoutes('/api/content/article/name-of-article')

// 稍后在应用中
const articleContent = await $fetch('/api/content/article/name-of-article', {
  responseType: 'json',
})
```

::warning
生产环境中预渲染的 API 路由可能不会返回预期的响应头，具体取决于你部署的服务提供商。例如，JSON 响应可能会被返回 `application/octet-stream` 的内容类型。
获取预渲染的 API 路由时务必手动设置 `responseType`。
::

---

- [源码](https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/ssr.ts)


## Sitemap

See the full [sitemap](https://nuxt.zhcndoc.com/sitemap.md) for all pages.