Nuxt 多语言 SEO:canonical、hreflang 怎么配

2026-11-19 前端开发 有希 39 次浏览

多语言站点的 canonical 不能全部指向中文:工具页要自指并输出 hreflang,博客正文则收敛到默认语言。下面按 Nuxt 4 门户的真实代码说明这套规则。

先分清内容页和索引页

结论:只有中文正文的页面才收敛到默认语言;有独立翻译的页面必须 canonical 自指,否则非默认语言版本很难被单独收录。

门户用 usePortalSeo 统一输出 SEO 标签,调用方通过 contentPage 决定走哪套规则:

页面类型例子canonicalhreflangsitemap
工具页、工具索引、分组页/toolkit/slug当前语言自己全语言 + x-default三种语言各一条
博客正文、分类、标签/blog/xxx默认语言不输出只输出默认语言
隐私、条款/privacy默认语言不输出只输出默认语言

这张表不是拍脑袋定的。工具页的标题、简介、SEO 文案都存在 tool_i18n 里,三种语言各自维护,属于真正独立的内容页;博客目前只有中文正文,英文和繁体页面只是同一篇内容的另一条路由,输出多语言 hreflang 只会制造重复内容。

canonical 全部指向中文会怎样

canonical 是“这一页的正本是谁”,hreflang 是“这些页面互为语言替代”。两个信号必须一致。

如果英文工具页的 canonical 指向中文页,同时 hreflang 又声明英文页是中文页的替代版本,搜索引擎会收到互相矛盾的指令。常见结果是英文页长期不被索引,或者索引了也不给排名。代码里对应这一行:

const canonical = computed(() => urlFor(options.contentPage ? DEFAULT_LOCALE : locale.value))

contentPage 为假时,locale.value 是当前语言;为真时才强制切换成默认语言 zh。这个判断必须由页面显式传入,不能靠路径猜:/blog 列表页有独立翻译,/blog/<slug> 正文没有,两者前缀相同。

hreflang 要按地区码输出

语言码和地区码不是一回事。繁体中文的路由前缀是 /zh-Hant,但 hreflang 要同时覆盖台湾和香港:

export const PORTAL_LOCALES: PortalLocale[] = [
  { name: '简体中文', code: 'zh', iso: 'zh-CN', prefix: '', hreflang: ['zh-CN'] },
  { name: '繁體中文', code: 'zh-Hant', iso: 'zh-TW', prefix: '/zh-Hant', hreflang: ['zh-TW', 'zh-HK'] },
  { name: 'English', code: 'en', iso: 'en-US', prefix: '/en', hreflang: ['en-US'] }
]

hreflang 字段是数组,一个语言可以输出多条 alternate。usePortalSeo 用 flatMap 展开,再补一条 x-default 指向默认语言:

...locales.value.flatMap((item) => {
  const code = typeof item === 'string' ? item : item.code
  const regions = HREFLANG_MAP[code]
  if (!regions) return []
  const href = siteUrl + localePath(path.value, code)
  return regions.map((hreflang) => ({ rel: 'alternate' as const, hreflang, href }))
}),
{ rel: 'alternate' as const, hreflang: 'x-default', href: defaultUrl.value }

这里最容易犯的错是写死两条链接。站点后来加一门语言,硬编码的模板不会跟着变,漏标等于白加。语言清单集中放在 shared/locale-routes.ts,路由、SEO、sitemap 三处共用,新增语言只改一个文件。

动态路由的 path 必须传 getter

分组页 /toolkit/group/[code] 在同一个组件内切换参数时,setup 不会重跑。如果 path 写成普通字符串,canonical 和 hreflang 会停在第一次渲染的地址上。

usePortalSeo({
  title: () => group.value?.seoTitle || fallbackTitle(),
  description: () => group.value?.seoDescription || fallbackDescription(),
  path: () => `/toolkit/group/${canonicalKey.value}`,
  noindex: () => isSearching.value || !group.value?.code
})

usePortalSeo 内部对 path 做了 toValue,传函数就会变成响应式值。文章页同理:

path: () => `/blog/${post.value?.slug || post.value?.id || idSlug.value}`

判断标准很简单:地址的任意一段来自路由参数或异步数据,就必须用 getter。

内容页为什么要“反着来”

博客正文页显式传 contentPage: true:

usePortalSeo({
  title: () => post.value?.seoTitle || post.value?.title || t('pages.blog.title'),
  description: () => post.value?.seoDescription || post.value?.summary || undefined,
  path: () => `/blog/${post.value?.slug || post.value?.id || idSlug.value}`,
  contentPage: true,
  type: 'article',
  image: post.value?.cover,
  publishedTime: post.value?.publishTime
})

结果是 canonical 固定到中文地址,alternate 一条都不输出。这样做的前提是英文、繁体页面没有独立正文。如果哪天文章也有了完整翻译,就必须把 contentPage 去掉,否则翻译版永远不会被单独收录。

sitemap 用同一个判断,multilingual: false 的页面只输出默认语言一条记录:

...archives.map((item) => ({
  path: `/blog/${item.slug || item.id}`,
  lastmod: item.publishTime ? String(item.publishTime).slice(0, 10) : '',
  multilingual: false
}))

页面上的 canonical 和 sitemap 里的地址必须一致。只改一处,爬虫会收到两种正本信号。

数据库文案与回退顺序

工具页的标题和描述不写死在前端。useToolSeo 优先取 CMS 返回的 seoTitle、seoDescription,取不到再回退 i18n:

const { data: tools } = useCmsTools('web')
const tool = computed(() => tools.value.find(item => item.path === path))

usePortalSeo({
  title: () => tool.value?.seoTitle || fallback.title,
  description: () => tool.value?.seoDescription || fallback.description,
  keywords: () => tool.value?.seoKeywords || fallback.keywords,
  path
})

工具列表故意不 await。SEO 字段以 getter 注册,SSR 渲染时 useAsyncData 已经完成,meta 拿到的是最终值;客户端数据晚到时,getter 也会触发更新。把工具列表 await 在 setup 顶层只会拖慢页面,并不会让 meta 更准。

数据库文案按 zh-CN、zh-TW、en-US 三种语言维护。繁体不是简体的机械转换,opencc 之后仍要人工校对:

自动转换应改为
位圖點陣圖
進位制進位
許可權權限

这类词一旦写错,页面能打开,但用户看到的术语是错的,比缺翻译更伤可信度。

验证:别只看首页

改完至少查三个地址:简体工具页、英文工具页、一篇博客正文。重点看 canonical 指向和 alternate 数量。

curl -s http://[::1]:3001/toolkit/slug | grep -E 'rel="canonical"|hreflang'
curl -s http://[::1]:3001/en/toolkit/slug | grep -E 'rel="canonical"|hreflang'
curl -s http://[::1]:3001/blog/paypal-capture-approved-idempotency | grep -E 'rel="canonical"|hreflang'
curl -s http://[::1]:3001/sitemap.xml | grep -c 'blog/paypal-capture-approved-idempotency'
验证项期望结果
英文工具页 canonical指向 /en/toolkit/slug
英文工具页 alternate包含 zh-CN、zh-TW、zh-HK、en-US、x-default
博客正文 alternate没有 hreflang
博客正文 sitemap 条数1 条,不带 /en、/zh-Hant 前缀

浏览器里还可以直接搜页面源码里的 canonical,但不要只测中文首页。多语言问题通常只在非默认语言路径上出现。

边界与常见错误

  • x-default 必须指向默认语言,不是英文。这个站点默认语言是 zh。
  • 搜索态页面是 query 派生的薄内容,noindex 要跟着 query 走,不能只在进入页面时判断一次。
  • 分组页用编号兜底访问时,canonical 仍要收敛到 code 地址;临时地址不该进索引。
  • slug 发布后不要改。canonical、sitemap、外链和已收录地址都会一起失效。
  • contentPage 只表示“没有独立翻译”,不表示“不重要”。两者不要混用。

相关工具

用 URL Slug 生成器 检查新页面 slug 是否稳定、是否全是小写;用 Meta 标签生成器 对照 canonical 与 hreflang 的输出格式。首屏渲染相关的排查可以看 Nuxt 4 页面首屏和浏览器显示不一致怎么排查,更多前端文章在 前端开发分类。

FAQ

hreflang 和 canonical 会冲突吗?

不会。canonical 声明正本,hreflang 声明语言替代关系。正确做法是每个语言版本 canonical 自指,同时把全部语言版本互相列为 alternate。

中文站一定要给英文页做 hreflang 吗?

只有在英文内容独立维护时才需要。如果英文页只是中文的机器翻译或占位,应该让 canonical 收敛到中文,而不是输出 hreflang。

canonical 能不能代替 301?

不能。canonical 是给搜索引擎的建议,301 才是强制跳转。页面永久迁移用 301,多语言正本选择用 canonical。

为什么 sitemap 里工具页有三条,文章只有一条?

因为工具页有独立的多语言文案,multilingual 为真;博客正文只有中文,multilingual 为假,只输出默认语言地址。

结语:先把页面分成“有独立翻译”和“只有中文正文”两类,再决定 canonical 和 hreflang;剩下的动态路由、数据库文案和 sitemap 都按同一套判断走。

评论

登录后即可参与评论

还没有评论,来说两句吧

相关文章