Nuxt 多语言 SEO:canonical、hreflang 怎么配
多语言站点的 canonical 不能全部指向中文:工具页要自指并输出 hreflang,博客正文则收敛到默认语言。下面按 Nuxt 4 门户的真实代码说明这套规则。
先分清内容页和索引页
结论:只有中文正文的页面才收敛到默认语言;有独立翻译的页面必须 canonical 自指,否则非默认语言版本很难被单独收录。
门户用 usePortalSeo 统一输出 SEO 标签,调用方通过 contentPage 决定走哪套规则:
| 页面类型 | 例子 | canonical | hreflang | sitemap |
|---|---|---|---|---|
| 工具页、工具索引、分组页 | /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 都按同一套判断走。
評論
還沒有評論,來說兩句吧