SaasOne v2.0 Docs
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,
    }))
  );
}