2026-11-21·5 分钟
SEO 与多语言元数据
分语种 metadata、sitemap、hreflang 与 OpenGraph 的完整接入,让 20 个语种都被搜索引擎正确收录。
分语种 metadata 与 canonical#
每个页面通过 generateMetadata 输出当前语种的标题、描述与 canonical 链接;alternates.languages 自动生成 hreflang 标签,告诉 Google 每个语种的对应路径:
typescriptapp/[locale]/xxx/page.tsx
import type { Metadata } from 'next';
import { getTranslations } from 'next-intl/server';
export async function generateMetadata({
params,
}: {
params: Promise<{ locale: string }>;
}): Promise<Metadata> {
const { locale } = await params;
const t = await getTranslations({ locale, namespace: 'pricing' });
const base = process.env.NEXT_PUBLIC_BASE_URL;
return {
title: t('title'),
description: t('description'),
alternates: {
canonical: `${base}/${locale}/pricing`,
languages: {
en: `${base}/pricing`,
zh: `${base}/zh/pricing`,
// 其余语种同型
},
},
openGraph: {
title: t('title'),
description: t('description'),
locale,
type: 'website',
},
};
}sitemap 与收录检查#
站点地图覆盖全部语种路由并随部署自动更新;提交到 Google Search Console / Bing Webmaster 后,通过「覆盖率」报告观察各语种收录情况:
验证工具
本地跑
pnpm build && pnpm start 后访问 /sitemap.xml 与任一页面的 view-source,确认 hreflang 与 OG 标签齐全;再交给 Search Console 的「网址检查」做实机验证。typescriptapp/sitemap.ts(核心结构)
import type { MetadataRoute } from 'next';
import { routing } from '@/i18n/routing';
const ROUTES = ['', '/pricing', '/features', '/docs', '/store'];
export default function sitemap(): MetadataRoute.Sitemap {
const base = process.env.NEXT_PUBLIC_BASE_URL!;
return routing.locales.flatMap((locale) =>
ROUTES.map((path) => ({
url: `${base}${locale === 'en' ? '' : '/' + locale}${path}`,
changeFrequency: 'weekly' as const,
priority: path === '' ? 1 : 0.7,
}))
);
}