Nuxt网站SEO生产配置

要解决的具体问题

Nuxt 项目在 SEO 上常面临配置分散、模块版本不兼容以及 v4 到 v5 迁移中的破坏性变更等问题。开发者需要手动拼凑 robots.txt、sitemap.xml、OG 图片和 Schema.org 结构化数据，导致配置文件臃肿且容易遗漏关键设置。例如，site.name 在 v5 中不再自动从 package.json 推断，若未显式设置，会导致站点标题、og:site_name 缺失以及 canonical URL 错误。

核心能力与关键步骤

该技能将 8 个官方 Nuxt SEO 模块整合为一套生产可用的配置方案：

• @nuxtjs/robots 管理 robots.txt 与爬虫检测，阻止 staging 环境被索引。
• @nuxtjs/sitemap 生成 XML 站点地图，支持 chunkSize 拆分大型站点地图。
• nuxt-og-image 通过 Vue 模板生成 Open Graph 图片，需注意 Satori 兼容的 CSS。
• nuxt-schema-org 构建 Schema.org 结构化数据，提升富媒体搜索结果展示。
• 其余模块涵盖链接检查、favicon 生成、站点配置管理等。

关键步骤包括：在 nuxt.config.ts 中显式设置 site.url 和 site.name，服务端使用 getSiteConfig(event) 替代已移除的 useSiteConfig(event)，并使用 defineSitemapSchema() 替代废弃的 asSitemapCollection()。配置完成后，可通过 /robots.txt、/sitemap.xml 以及 v5 新增的 /__robots__/debug-production.json 等调试路由验证。

适用边界与注意点

• 技能默认不自动安装依赖、修改系统权限或执行外部写入操作，所有代码与命令仅作参考，需用户明确确认后执行。
• v5 存在多项破坏性变更，升级前需阅读迁移指南，逐一修正已废弃的 Composable。
• OG 图片渲染对 CSS 有严格要求，不兼容的样式可能导致生成失败，建议使用官方模板或切换至 Chromium 渲染器。
• 涉及发送、发布、删除、付款、部署等外部操作时，技能会先展示目标与影响，等待用户确认。