- 协议
- 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 里一条条配置,所以既能做内容站,也能做电商和后台应用。
仓库链接
- 仓库:https://github.com/nuxt/nuxt
- 官网:https://nuxt.com/
- 文档:https://nuxt.com/docs
- 官方模板库:https://nuxt.com/templates
- 官方作品展示:https://nuxt.com/showcase
适用场景
- 适合:用 Vue 的团队要做的电商与品牌官网(首屏快、利于搜索引擎收录)、SaaS 产品与管理后台、内容站与文档站、需要前后端放在一个仓库里的中小项目。
- 也能做:用
nuxt generate整站导出成静态文件放到任意静态托管;按路由混合渲染(首页静态、商品页服务端渲染、后台纯客户端);配合官方组件库 Nuxt UI 和模板快速搭出后台、落地页、AI 聊天应用。 - 不太适合:不用 Vue 的团队(React 生态对应的是 Next.js);纯内容、几乎没有交互的小站(Astro 更轻);只需要一个纯前端单页应用、没有服务端的项目(直接用 Vite + Vue 更简单)。
上手示例
用官方脚手架建项目(选 minimal 模板):
npm create nuxt@latest my-app
cd my-app
npm run dev把 app/app.vue 换成下面的内容,再新建 server/api/hello.ts:
<!-- 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>// 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.js | React 生态里对应的全栈框架,生态与资料更多 |
| SvelteKit | 想要更少的运行时代码、喜欢 Svelte 写法的团队 |
| Astro | 以内容为主、交互很少的网站,默认几乎不发 JavaScript |
延伸阅读
- 官方文档(从安装到部署):https://nuxt.com/docs
- 渲染模式说明(服务端渲染、静态生成与混合渲染):https://nuxt.com/docs/4.x/guide/concepts/rendering
- 官方模块目录:https://nuxt.com/modules
- 官方组件库 Nuxt UI:https://ui.nuxt.com/
作品展示
官方作品展示页收录了 Louis Vuitton、Nintendo、GitLab、Roland-Garros、NASA 喷气推进实验室等几十家公司和机构的网站,官方模板库还有一批可以直接点开体验的演示站。下面挑两个官方模板的在线演示和三个知名网站。
官方示例用 Nuxt 和官方组件库 Nuxt UI 做的管理后台模板:左侧导航、数据卡片、收入曲线、订单表格、收件箱和设置页一应俱全,可以直接点开体验,是做后台系统的现成起点。
官方示例同样基于 Nuxt UI 的产品落地页模板:超大号标题、终端演示、功能卡片、数据指标和行动号召等区块,深色风格加荧光色点缀,改改文案和配色就能用来做产品官网。
作品展示任天堂欧洲的英国站:首屏是大幅游戏海报轮播,左侧是红色的竖排分类导航,往下是新闻、优惠和游戏推荐,内容多、图片重,正适合服务端渲染保证首屏速度。
作品展示四大满贯之一法网的官方网站:首屏是菲利普·夏蒂埃球场的全景大图,下面滚动着新闻头条,赛事期间还要承载比分、赛程和直播等高并发访问。
作品展示知名的代码托管与 DevOps 平台的官网:深色网格背景配超大号标题,产品、方案、价格、资源等多级导航,是一个内容量很大的企业营销站。
