nuxt-seo

Nuxt SEO

npx nuxi module add @nuxtjs/seo

使用场景

适用于以下工作：

• SEO 配置（网站 URL、名称、是否允许索引）
• 生成 robots.txt 和 sitemap.xml
• 动态生成 OG 图片
• JSON-LD 结构化数据（schema.org）
• 面包屑导航和规范 URL

加载文件

根据任务考虑加载以下参考文件：

• references/site-config.md - 配置网站 URL、名称或 SEO 基础设置时
• references/crawlability.md - 设置 robots.txt 或 sitemap.xml 时
• references/og-image.md - 生成动态 OG 图片时
• references/schema-org.md - 添加 JSON-LD 结构化数据时
• references/utilities.md - 处理面包屑导航、规范 URL 或链接检查时

**不要一次性加载所有文件。**仅加载与当前任务相关的文件。

网站配置

所有 SEO 模块的基础。在 nuxt.config.ts 中配置 site，通过 useSiteConfig() 访问。完整选项请参阅 references/site-config.md。

模块概览

模块	用途	主要 API
nuxt-site-config	共享配置	useSiteConfig()
@nuxtjs/robots	robots.txt	useRobotsRule()
@nuxtjs/sitemap	sitemap.xml	defineSitemapEventHandler()
nuxt-og-image	OG 图片	defineOgImage()
nuxt-schema-org	JSON-LD	useSchemaOrg()
nuxt-seo-utils	Meta 工具	useBreadcrumbItems()
nuxt-link-checker	链接验证	构建时检查

Nuxt Content v3

使用 asSeoCollection() 根据 frontmatter 自动生成站点地图、OG 图片和 schema.org 数据：

// content.config.ts
import { defineCollection, defineContentConfig } from '@nuxt/content'
import { asSeoCollection } from '@nuxtjs/seo/content'

export default defineContentConfig({
  collections: {
    posts: defineCollection(asSeoCollection({ type: 'page', source: 'posts/**' }))
  }
})

**重要：**在 modules 数组中，先加载 @nuxtjs/seo，再加载 @nuxt/content：

export default defineNuxtConfig({
  modules: ['@nuxtjs/seo', '@nuxt/content']
})

Frontmatter 字段：ogImage、sitemap、robots、schemaOrg。

相关技能

• nuxt-content - 使用 SEO frontmatter 进行 MDC 渲染

链接

• 文档
• GitHub

令牌效率

主技能：约 250 个令牌。每个子文件：约 400–600 个令牌。仅加载与当前任务相关的文件。