用途:Nuxt Content v3 是 Nuxt 项目的 Git 基 CMS,通过 Markdown、YAML、JSON、CSV 文件管理内容,把内容文件转为结构化数据,适合博客、文档站与内容驱动应用。
主要能力:内容集合(collections)组织内容并生成类型;SQL 存储(需 better-sqlite3)优化查询,兼容服务端/无服务器/边缘/静态;完整 TypeScript 集成;支持 Zod 或 Valibot 做 Schema 校验;查询 API 支持 where、sort、limit、offset、count、only、without;自动生成导航树;全文搜索;MDC(Markdown Components)语法;Nuxt Studio 集成实现自托管内容编辑与 GitHub 同步。
使用方式:安装 @nuxt/content 与 better-sqlite3,在 nuxt.config.ts 的 modules 数组注册 '@nuxt/content',在 content.config.ts 用 defineCollection 定义集合与 schema,然后用 queryCollection 查询并以 ContentRenderer 渲染。改动 content.config.ts 后需重启开发服务器。
适用场景:博客、文档、内容型应用、Git 内容工作流、类型安全查询、Cloudflare Pages/Workers(D1 绑定名必须为 DB)或 Vercel 部署。
限制与注意事项:集合必须先定义再查询;日期须用 ISO 8601 格式;MDC 组件放在 components/content/ 且名称匹配;数字前缀需补零(01-);代码块要标注语言;摘要需用 <!--more-->;Cloudflare 的 D1 绑定名大小写敏感必须为 DB;新增内容未出现在导航时可清 .nuxt 缓存。官方文档:https://content.nuxt.com。