Nuxt 4 SSR 入门笔记

管理员
管理员
发布于 2026-09-01 编辑

Nuxt 4 SSR 入门笔记

Nuxt 4 默认开启 SSR,源码目录迁移到了 app/,服务端代码放在根目录 server/

目录约定

  • app/pages/:基于文件的路由
  • app/components/:组件自动导入
  • app/composables/:组合式函数自动导入
  • server/api/:Nitro 服务端接口

一个最小接口

TypeScript
// server/api/hello.get.ts
export default defineEventHandler(() => {
  return { message: 'hello' }
})

提示:服务端代码可以直接使用 defineEventHandlerreadBody 等自动导入的工具。

渲染模式

路由类型 推荐模式 说明
列表 / 详情 SSR 首屏直出,利于 SEO
编辑器等强交互页 CSR 依赖 DOM 的库用 <ClientOnly> 包裹

先写这么多,后续补充数据请求(useFetch / $fetch)的最佳实践。