Docsbook
概览

多语言文档 SEO：hreflang 与 URL

2026 年的大多数产品文档都只有英文版。妥善进行翻译的团队能够获取仅提供英文版本的网站永远无法获得的自然流量——来自日语、西班牙语、德语和普通话的相同购买意图搜索。

这篇文章是一份实用的 SEO 指南，介绍如何以 15 种语言发布文档，同时不影响 Google 或 AI 搜索。

简而言之#

  • 每种语言都必须使用单独的 URL（/ja/、/es/、/de/）
  • 添加 hreflang 标签，以便搜索引擎了解哪些内容是哪些内容的翻译
  • 在 <html> 元素上使用 lang 属性
  • 2026 年的 AI 翻译已经足以应对文档翻译（不适用于营销文案）
  • 一个规范的英文源版本，加上 AI 翻译——绝不重复维护源内容

基本规则#

每个（页面、语言）组合对应一个 URL。

错误：

docs.yourcompany.com/quick-start?lang=ja
docs.yourcompany.com/quick-start (with cookies)

正确：

docs.yourcompany.com/quick-start
docs.yourcompany.com/ja/quick-start
docs.yourcompany.com/es/quick-start

如果没有单独的 URL，搜索引擎就无法为每种语言建立索引：一个 URL 在其索引中对应一份文档，因此它看到的语言就是唯一能够获得排名的语言。无论翻译质量多高，其他所有区域设置在其自身语言的搜索结果中都是不可见的。

hreflang 设置#

每个页面都需要指向每个翻译版本的 <link rel="alternate" hreflang="..."> 标签。

<link rel="alternate" hreflang="en" href="https://docs.yourcompany.com/quick-start">
<link rel="alternate" hreflang="ja" href="https://docs.yourcompany.com/ja/quick-start">
<link rel="alternate" hreflang="es" href="https://docs.yourcompany.com/es/quick-start">
<link rel="alternate" hreflang="x-default" href="https://docs.yourcompany.com/quick-start">

x-default 告诉 Google：“如果没有其他区域设置匹配，则显示此版本。”通常是英文版本。

在“设置 → 语言”中启用语言后，Docsbook 会自动生成 hreflang。

AI 翻译何时已经足够好#

三个因素：

内容类型 AI 翻译质量 建议
参考文档（API、配置） 高 使用 AI
教程和操作指南 高 使用 AI，进行简要人工审核
营销落地页 中等 需要人工审核
品牌文案（标语、使命） 低 人工翻译
代码示例 不适用 保持原样
错误消息 术语一致时较高 使用 AI

2023 年至 2026 年间，大语言模型对技术内容的翻译质量显著提升。具体对于文档而言，机器翻译相较于人工流程具有结构性优势，而不仅仅是价格优势：

  • 术语一致性。 模型会在一千个页面中对同一概念使用相同的术语；而轮换的人工译者群体会逐渐出现偏差，直到读者提交相关问题报告，这种偏差才会被发现。
  • 速度。 几分钟内完成十五种语言的翻译，而不是每种语言都经历一次报价和排期流程。
  • 修订成本。 人工翻译的真正开销不在于首次翻译，而在于后续的每一次修订：修改一个段落，就需要在每种语言中按字数再次付费。机器翻译则会重新计算发生更改的页面。这就是为什么人工流程下的翻译文档会逐渐过时，而机器翻译流程下的文档能够保持最新。

人类仍然更擅长的方面：

  • 文化本地化（日期格式、示例、品牌语调）
  • 高风险法律文案
  • 营销标语

对于文档而言，到 2026 年，成本效益已经明显倾向于使用 AI 翻译。

每种语言分别建立索引#

有三个信号很重要：

  1. URL 模式 — /ja/ 子目录或 ja.yourdomain.com 子域名（子目录更容易实现）
  2. hreflang 标签 — 双向设置，在所有版本之间相互指向
  3. lang 属性 — 日文版本上使用 <html lang="ja">
  4. 站点地图条目 — 每种语言都有自己的条目，并带有 xhtml:link 注释

然后，Google 会在各自地区的搜索结果中对每种语言分别进行排名。在日本用日语搜索的用户会看到 /ja/。在西班牙用西班牙语搜索的用户会看到 /es/。

AI 搜索引擎如何处理翻译#

观察到的三种行为：

ChatGPT#

如果查询使用某种语言，ChatGPT 会引用该语言的页面。向 ChatGPT 提问“请比较文档平台”（日语）会返回日语来源，包括文档的日语版本。

Perplexity#

与 ChatGPT 一样——Perplexity 严格将查询语言与来源语言匹配。如果你翻译得好，就能为每种语言获得一个引用渠道。

Gemini#

Google Gemini 使用 Google 的底层索引。帮助 Google AI 概览的相同 hreflang 和区域设置信号也会帮助 Gemini。

Docsbook 如何提供多语言#

启用一种语言需要三个步骤：

  1. 控制面板 → 设置 → 语言 → 选择语言 → 启用
  2. AI 会将整套文档翻译成该语言；翻译运行的费用将按美元从项目余额中扣除
  3. 页面会显示在 /{language-code}/{path}，并正确设置 hreflang 和 lang

支持 15 种语言：EN、ES、FR、DE、PT、IT、RU、ZH、JA、KO、AR、HI、TR、PL、NL。

如果您有人工译员，也可以通过 MCP 工具 upload_translation 或管理界面上传自己的翻译。

翻译模式#

有三种模式可用：

  • 自动 — Docsbook AI 自动翻译所有内容
  • 手动 — 待处理翻译队列，发布前由你审核
  • 外部 — 通过 webhook 接入你自己的翻译流程（你的 TMS、你的译员）

外部模式适用于已经拥有翻译记忆库并希望继续使用它的团队。set_translation_mode MCP 工具可在模式之间切换。

导致多语言 SEO 失败的错误#

  • 通过查询参数切换 (?lang=ja) — Google 不会将这些页面作为独立页面编入索引
  • 基于 Cookie 的语言检测 — 存在同样的问题，最终只有一个 URL 会被编入索引
  • 缺少 hreflang 标签 — Google 会将翻译页面视为重复内容
  • 单向 hreflang — 两个页面必须相互引用
  • 没有 lang 属性 — 屏幕阅读器和爬虫会回退到英语

成本效益#

将 200 个页面翻译成另外 14 种语言：

自行人工翻译 Docsbook AI 翻译
成本 按词计费，按语言报价，每次修订都需再次付费 根据项目余额，按每次翻译运行量计费
时间 数月 数小时
更新成本 源页面发生变化时，按词再次收费 源页面发生变化时重新计算
SEO 索引 手动设置 hreflang 按语言区域自动设置
适用场景 法律、受监管和营销文案，必须由人工审核批准 经常变化的参考资料和操作指南内容

机器翻译并非绝对更好。它更擅长处理导致大多数翻译项目陷入困境的环节，而这不是首次翻译，而是第二十次修订。

免费开始 — 无需信用卡

后续步骤#

此页面对您有帮助吗？

由...提供支持 Docsbook