Nuxt:用 Vue 写全栈网站,路由、渲染、接口都配好了

基于 Vue 的全栈 Web 框架:文件即路由、自动引入、服务端渲染开箱即用

前端 / 全栈 Web 框架6.1 万
Nuxt
协议
MIT
Star 数
约 6.1 万(61,092)
最新版本
v4.6.4(2026-11-02 发布)
运行环境
Node.js 22 及以上;基于 Vue 3

Star 数、版本等数据截至 2026 年 11 月。 技术栈:TypeScriptVueViteNitro

定位

一句话:基于 Vue 的全栈 Web 框架:文件即路由、自动引入、服务端渲染开箱即用

Vue 只管"界面怎么画",路由、服务端渲染、打包、接口都要自己搭。Nuxt 把这些都定好了:app/pages/ 里的文件就是网站的路由,ref、useFetch 和自己写的组件不用 import 就能直接用,页面默认先在服务器上渲染好再交给浏览器"接管"交互;同一个项目的 server/ 文件夹里还能直接写后端接口(底层是 Nitro 服务引擎)。每个路由用静态生成、服务端渲染还是纯客户端渲染,都可以在 routeRules 里一条条配置,所以既能做内容站,也能做电商和后台应用。

仓库链接

适用场景

  • 适合:用 Vue 的团队要做的电商与品牌官网(首屏快、利于搜索引擎收录)、SaaS 产品与管理后台、内容站与文档站、需要前后端放在一个仓库里的中小项目。
  • 也能做:用 nuxt generate 整站导出成静态文件放到任意静态托管;按路由混合渲染(首页静态、商品页服务端渲染、后台纯客户端);配合官方组件库 Nuxt UI 和模板快速搭出后台、落地页、AI 聊天应用。
  • 不太适合:不用 Vue 的团队(React 生态对应的是 Next.js);纯内容、几乎没有交互的小站(Astro 更轻);只需要一个纯前端单页应用、没有服务端的项目(直接用 Vite + Vue 更简单)。

上手示例

用官方脚手架建项目(选 minimal 模板):

Bash
npm create nuxt@latest my-app
cd my-app
npm run dev

把 app/app.vue 换成下面的内容,再新建 server/api/hello.ts:

Vue
<!-- app/app.vue -->
<script setup lang="ts">
// useFetch 在服务器渲染时就把数据取好,浏览器收到的 HTML 里已经有内容
const { data } = await useFetch('/api/hello')
const count = ref(0) // ref、useFetch 都不用 import,Nuxt 自动引入
</script>

<template>
  <main style="padding: 48px; font-family: sans-serif">
    <h1>你好,Nuxt</h1>
    <p>接口说:{{ data?.message }}(服务器时间 {{ data?.time }})</p>
    <button @click="count++">点了 {{ count }} 次</button>
  </main>
</template>
TypeScript
// server/api/hello.ts:server/api/ 下的文件自动变成接口 GET /api/hello
export default defineEventHandler(() => ({
  message: '你好,Nuxt',
  time: new Date().toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' }),
}))

打开 http://localhost:3000 能看到标题、接口返回的问候和服务器时间,按钮点一下数字加一。查看网页源代码会发现,接口的数据已经写在服务器返回的 HTML 里了——这就是服务端渲染:页面先在服务器上取好数据、渲染成 HTML,浏览器拿到后再"接管"按钮这类交互。直接访问 http://localhost:3000/api/hello 会返回一段 JSON。运行 npm run build 后,用 node .output/server/index.mjs 就能把整个网站和接口跑起来。

优点

  • 约定优于配置,上手快:文件即路由、组件和组合式函数自动引入、TypeScript 开箱即用,写 Vue 的人几乎不用学新语法就能做出完整网站。
  • 渲染方式灵活:服务端渲染、静态生成、纯客户端渲染可以按路由混用(routeRules),兼顾首屏速度、搜索引擎收录和后台交互。
  • 前后端一个项目:server/ 里写接口,useFetch 调用时类型自动贯通;底层的 Nitro 能把同一份代码部署成 Node.js 服务、静态站点或各家云平台的边缘函数。
  • 模块生态丰富:官方模块目录收录了 370 个模块(UI 组件、内容管理、图片优化、国际化、认证等),一行配置就能接入;MIT 协议,可自由商用和自行部署。

缺点

  • "自动"也意味着"隐式":自动引入和目录约定让代码变短,但新人一开始可能搞不清某个函数是从哪来的;项目大了要靠编辑器插件和 DevTools 帮忙看清楚。
  • 服务端渲染有门槛:要分清哪些代码在服务器上跑、哪些只在浏览器里跑(比如服务端没有 window),数据取两次、页面"接管"时内容对不上(hydration mismatch)是常见的坑。
  • 大版本迁移有成本:从 Nuxt 2 到 3 几乎要重写,3 到 4 改了默认目录结构(代码移到 app/ 下),老项目升级要照官方迁移指南逐步改。
  • 生态规模比 React 系小:招人、第三方组件和教程的数量都不如 Next.js 多,部分模块的维护活跃度参差不齐,选用前要看看更新情况。

同类对比

框架更适合
Next.jsReact 生态里对应的全栈框架,生态与资料更多
SvelteKit想要更少的运行时代码、喜欢 Svelte 写法的团队
Astro以内容为主、交互很少的网站,默认几乎不发 JavaScript

延伸阅读

作品展示

官方作品展示页收录了 Louis Vuitton、Nintendo、GitLab、Roland-Garros、NASA 喷气推进实验室等几十家公司和机构的网站,官方模板库还有一批可以直接点开体验的演示站。下面挑两个官方模板的在线演示和三个知名网站。