功能特性 使用场景 定价
博客 文档 更新日志
登录
立即开始

Polylang 多语言文字转语音：实测有效的配置方案

2 分钟阅读 22 分钟收听
Polylang 多语言文字转语音：实测有效的配置方案
WordPress 使用技巧

Polylang 文字转语音的核心要求是：每篇翻译文章生成一个独立的音频文件，使用正确的语言和声音。由于 Polylang 将每个翻译版本都作为独立的 WordPress 文章存储并分配唯一 ID，按文章生成音频的方式可以直接兼容这一架构。真正需要注意的是声音匹配、Cookie 重定向和页面缓存，而不是音频生成本身。

本文是我们多语言 TTS 系列的第四篇。前几篇分别介绍了 WPML、Weglot 和 GTranslate 3.3.0 版本更新。Polylang 在架构上与 WPML 最为接近，但有自己的特性。以下是我们在生产环境中使用 文字转语音 - TTSWP 实测后的结论。

为什么 Polylang 站点需要关注文字转语音

Polylang 是 WordPress 免费多语言插件中装机量最高的，活跃安装数超过 80 万，在同类免费插件中位居首位。该插件于 2011 年发布，至今仍在持续维护。它支持无限制添加语言，WordPress 语言包会自动下载。使用 Polylang 的站点大多是博客、小型内容平台和预算有限的建站机构，选择它的原因是核心功能免费且架构简洁。

正因如此，很多 TTS 插件虽然声称支持 Polylang，却只测试了默认语言。它们只为文章生成一个音频文件，然后在所有翻译版本上播放同一个文件。西班牙语页面播放英语音频，德语页面则完全没有声音。访客自然会离开。

解决方案在于架构设计。Polylang 不新增数据库表，也不使用短代码，而是基于 WordPress 的分类系统构建，和分类目录、标签使用的是同一套底层机制。每个翻译版本都是一篇真实的文章。因此，TTSWP 按文章生成音频的方式与 Polylang 的内容存储结构完全吻合。

Polylang 与 Weglot、GTranslate 的核心区别

Polylang 通过复制文章来管理多语言内容，Weglot 和 GTranslate 则在页面渲染时实时翻译。这一根本差异决定了 TTS 支持的实现方式。

在 Polylang 站点上，"关于我们"页面的德语翻译是一篇独立的 WordPress 文章，文章 ID 为 412，语言标识为 "de"，内容单独存储在数据库中。WordPress 核心、REST API，以及任何挂载了 save_post 或 wp_insert_post 钩子的 TTS 插件，都能识别这篇文章。音频按翻译版本各生成一次，使用对应语言，并以文章 ID 为键进行缓存。

Weglot 和 GTranslate 的工作方式不同。翻译内容只在用户请求页面时才会生成，没有第二篇文章可以关联音频。我们在之前的文章中分别介绍了 Weglot 和 GTranslate 的处理方案。WPML 与 Polylang 采用相同的文章复制模型，因此我们的 WPML 指南稍作调整后同样适用于 Polylang。

对于 TTS 来说，这是一个好消息。Polylang 提供了所需的一切：每种语言对应一个稳定的文章 ID、已知的语言标识，以及不会在渲染时变化的固定链接。

对比 Polylang 文章复制模式与 Weglot 实时渲染翻译模式的架构示意图
Polylang 为每种语言创建独立的文章，这正是按文章生成 TTS 音频所需要的架构。

Polylang 的四种 URL 结构及其对 TTS 的影响

Polylang 提供四种 URL 模式，每种模式对缓存、CDN 和语言检测逻辑的影响各不相同。选错模式，正确的音频文件就会出现在错误的 URL 下。

1. 仅通过内容判断语言（URL 中不含语言标识）

这是最难处理的情况。example.com/about 这个 URL 对一个访客显示英语内容，对另一个访客显示德语内容，取决于 Cookie 或浏览器语言检测。页面缓存只看到一个 URL，只会存储一个版本，先被缓存的语言版本会覆盖其他版本。

对于 TTS，音频文件本身没有问题，因为它以文章 ID 为键，而不是 URL。问题出在嵌入播放器的页面上。如果缓存的英语页面加载了德语音频播放器，播放出来的是德语内容，但页面显示的是英语文本。在任何开启了缓存的站点上，我们都不建议使用这种 URL 模式。

2. 目录式 URL（/en/、/de/）

这是默认模式，也是我们推荐的配置。每种语言都有自己的路径，缓存会将 /en/about 和 /de/about 视为不同的缓存键。正确的页面加载正确的播放器和音频文件，不需要 Cookie 处理。

注意"为默认语言隐藏 URL 语言信息"这个选项。启用后，默认语言的 URL 会去掉前缀：/about 变成英语，/de/about 仍然是德语。这时，第三方代码通过 URL 判断语言的逻辑在默认语言路径下会失效，因为 URL 中没有语言标识。如果使用了这个选项，建议通过 pll_current_language() 而不是解析 URL 来获取当前语言。

3. 子域名（en.example.com、de.example.com）

子域名方式为每种语言提供独立的域名和缓存命名空间，TTS 播放器按语言加载，互不干扰。代价是需要管理 DNS 和为每个子域名配置 SSL 证书，同时分析统计也会稍复杂一些。在较大规模的站点上运行良好。

4. 每种语言独立域名

完全独立的方案：英语用 example.com，德语用 example.de。TTS 仍然以每个 WordPress 安装中的文章 ID 为键存储音频，播放器工作方式不变。这种模式常见于已拥有国家顶级域名的品牌。

Cookie 重定向问题

Polylang 可以在访客第一次访问首页时检测其浏览器语言，随后设置 pll_language Cookie 并将访客重定向到对应的语言版本。与页面缓存结合使用时，这里最容易出现语言错乱的音频问题。

以下是我们复现过的故障流程：一位法语用户访问首页，Polylang 检测到法语，设置 pll_language Cookie 并重定向到 /fr/。缓存将这个重定向响应存储在首页 URL 下。下一位英语访客请求首页，拿到的是缓存的重定向，被导向法语页面，听到法语音频，然后离开。

使用目录式 URL 时，问题只会影响首页，因为其他页面都有各自独立的缓存键。使用"仅通过内容判断语言"模式时，同样的问题会扩散到站点的每一个 URL。

有三种解决方案。最简单的是在所有开启缓存的站点上关闭浏览器语言自动检测，让访客通过语言切换器手动选择。第二种是配置缓存插件，针对 pll_language Cookie 进行缓存分组或跳过缓存。第三种是将首页排除在页面缓存之外，让语言检测和重定向每次都实时执行。

如果你使用 WP Rocket、W3 Total Cache 或 LiteSpeed，请查看我们的缓存集成文档了解 Cookie 配置方法。Polylang 可以与这些缓存插件共存，但"共存"并不等于"自动感知语言"，缓存配置仍需手动完成。

前端 AJAX 的语言处理

Polylang 会自动检测前端 AJAX 请求的当前语言，并加载对应语言的字符串。你也可以在请求中传入显式的 lang 参数来强制指定语言。当音频播放器或相关文章组件通过 AJAX 请求获取其他文章时，这一点就变得重要。

在我们的测试中，Polylang 对此处理得很稳定。我们没有遇到 WPML 文章中记录的 AJAX 语言错乱问题。如果自定义集成需要获取非当前语言的文章，请显式传入 lang 参数，并在读取结果前通过 function_exists('pll_current_language') 确认函数存在。

在 Polylang 站点上配置 文字转语音 - TTSWP

以下步骤假设 Polylang 已安装，且至少已存在一个翻译版本。

  1. 安装 文字转语音 - TTSWP，从 WordPress.org 插件页面下载并激活。如果遇到权限错误，请参阅安装文档。
  2. 将插件连接到 TTSWP 账户，按照连接指南操作。免费套餐包含初始额度，可以在选择付费方案前先行测试。
  3. 打开原始语言文章并生成音频，确认播放器在前端正常显示。
  4. 在文章编辑器中切换到翻译版本，通过 Polylang 语言切换器操作，再次生成音频。Polylang 已加载了不同的文章 ID，TTSWP 会将其视为全新的生成任务并单独存储文件。
  5. 为每个翻译版本选择声音。声音设置在文章层级完成，请参阅声音选择文档了解单篇文章的覆盖设置方式。
  6. 在前端验证效果。在不同标签页中分别打开 /en/post-slug 和 /de/post-slug，各自播放，确认声音和语言与页面内容一致。

目前，TTSWP 的按语言默认声音映射优先支持 WPML 和 Weglot。在 Polylang 站点上，声音选择在文章层级进行，按语言默认设置通过下文介绍的文章语言读取机制实现。对于大多数 Polylang 站点来说，这已经足够用了，因为每个翻译版本都是独立的文章，声音只需在每篇文章上设置一次。详情请参阅 Polylang 集成文档。

WordPress 文章编辑器截图，显示 Polylang 语言切换器与 TTSWP 音频面板并排展示
每个 Polylang 翻译版本都是独立的文章，因此音频生成和声音选择都在各自的翻译版本上单独完成。

如何正确读取文章语言来匹配声音

在 Polylang 中读取文章语言的正确方式是使用 pll_get_post_language()。按照 Polylang 官方开发建议，调用前始终要确认函数存在。代码示例如下：

if ( function_exists( 'pll_get_post_language' ) ) {
    $lang = pll_get_post_language( $post_id, 'slug' );
    // $lang 的值为 'en'、'de'、'fr' 等
}

在前端场景中，pll_current_language() 返回当前请求的语言。这两个函数都很稳定，已是 Polylang 公开 API 的一部分多年。声音映射逻辑应始终读取文章语言，而不是站点默认语言，否则翻译版本会继承错误的声音。

Polylang 免费版与 Pro 版对 TTS 的影响

Polylang Pro 的任何功能都不是音频生成的必要条件。Polylang 免费版已提供 TTSWP 所需的一切：按文章复制、语言标识，以及上述公开 API 函数。

Polylang Pro 增加了 DeepL 机器翻译、REST API 支持、翻译 URL 别名，以及用于外包翻译的 XLIFF 导出功能。这些功能对博客和普通页面的 TTS 使用没有影响。Polylang for WooCommerce 是一个独立的付费扩展，用于管理店铺页面、商品分类、属性和交易邮件。如果需要为商品描述添加语音朗读，请参阅我们的 WooCommerce TTS 指南。

多语言音频的 SEO 与 AEO 优化

Polylang 会自动处理 hreflang 标签，这已经完成了多语言 SEO 的大部分工作。在此基础上，为每个语言版本添加 AudioObject 结构化数据，并将其指向该翻译版本对应的音频文件，可以向搜索引擎传递清晰的信号。

在我们的测试中，同时包含音频和 AudioObject schema 的文章被 AI 搜索引擎引用的频率明显更高。我们在 AEO 与音频内容一文中详细记录了方法和结果。简单来说：每个翻译版本一个音频文件，每个翻译版本对应一组 schema，AEO 收益自然跟上。

常见问题与解决方案

现象可能原因解决方案
翻译版本使用了错误的声音声音在全局设置，未在文章层级单独配置打开翻译版本文章，在该文章上设置声音，重新生成音频
某种语言没有音频该翻译版本从未生成过音频在编辑器中打开该翻译版本文章，点击生成
缓存页面加载了错误语言的播放器缓存存储了语言检测重定向或单一语言版本的页面关闭浏览器语言自动检测，或配置缓存针对 pll_language Cookie 进行分组
阿拉伯语或希伯来语播放器布局异常播放器未应用 RTL 样式通过自定义 CSS 添加 RTL 覆盖样式
播放器界面文字保持默认语言不变插件字符串未注册用于翻译使用 pll_register_string 注册播放器字符串，让 Polylang 在字符串翻译界面中显示这些内容
所有文章的音频都以默认语言生成声音映射读取的是站点语言而非文章语言通过 pll_get_post_language($post_id, 'slug') 确认文章语言
示意图展示三种语言路径各自拥有独立的缓存键和音频文件，包含阿拉伯语的 RTL 布局
目录式 URL 让每个翻译版本拥有独立的缓存键，避免错误音频出现在错误的页面上。

无障碍访问说明

为每种语言单独添加语音朗读，同时也是对无障碍访问的改善。对于习惯以母语阅读、同时又偏好收听内容的访客，这两种方式都能照顾到。如果你的站点需要符合 WCAG 2.2 或欧洲无障碍法案，请参阅我们的 WCAG 音频合规指南了解具体要求。如需了解 2026 年为 WordPress 站点添加 TTS 的完整流程，主教程涵盖了所有基础内容。

常见问题解答

Polylang 支持文字转语音吗？

支持。Polylang 将每个翻译版本作为独立的 WordPress 文章存储，各自拥有唯一 ID，这与 TTSWP 按文章生成音频的架构完全吻合。为每个翻译版本生成音频后，每种语言就有了一个使用你所选声音的独立音频文件。Polylang 免费版即可满足需求，无需在标准 TTSWP 配置之外进行任何特殊设置。

需要 Polylang Pro 才能使用音频功能吗？

不需要。Polylang 免费版已提供 TTSWP 所需的全部内容：按语言复制文章、语言标识，以及 pll_get_post_language() 和 pll_current_language() 这两个公开 API 函数。Polylang Pro 增加了 DeepL 机器翻译、REST API 支持和翻译 URL 别名，这些功能不影响音频的生成和播放。

每种语言可以使用不同的声音吗？

可以。由于每个翻译版本都是独立的文章，声音选择在文章层级进行。在德语翻译版本上选择德语声音，在西班牙语版本上选择西班牙语声音，以此类推。TTSWP 会记住每篇文章的声音设置，每次重新生成时都会使用相同的声音。请参阅语言与声音映射文档了解当前的功能说明。

为什么音频播放的语言不对？

最常见的原因是页面缓存与 Polylang 浏览器语言自动检测同时启用。缓存存储了首页重定向或某一语言版本的页面，然后对所有访客提供同样的内容。音频文件本身对应的文章 ID 是正确的，问题出在加载它的页面上。在开启缓存的站点上关闭浏览器语言检测，或者配置缓存插件针对 pll_language Cookie 进行分组。使用目录式 URL（/en/、/de/）可以将问题限制在首页范围内，因为其他页面都有各自独立的缓存键。

Polylang 与 WPML 在 TTS 方面有什么区别？

两者都是按语言复制文章，因此按文章生成音频的方式在两个插件上效果相同。区别在于 AJAX 处理方式、Cookie 行为，以及开发者 API 的命名。Polylang 使用 pll_ 前缀的函数，整体更轻量。WPML 内置了更多 WooCommerce 功能，但插件体积也更大。具体细节请参阅我们的 WPML 文章。

可以翻译播放器的界面文字吗？

可以，但需要一个额外步骤。如果插件通过 pll_register_string() 注册了界面字符串，Polylang 会在字符串翻译界面中显示这些内容。如果你希望播放按钮、进度条标签或其他播放器文字能随语言切换，请在子主题或专用的站点功能插件中注册这些字符串，它们就会出现在"语言 - 字符串翻译"界面中。

下一步操作

在 WordPress 编辑器中打开一篇翻译文章，查看音频面板。如果默认显示的语言已经正确，配置就完成了。如果不对，在该翻译版本上设置声音，重新生成，然后检查前端效果。一个翻译版本配置好之后，其余的都按同样的方式操作。

如果还没有安装 文字转语音 - TTSWP，请从 WordPress.org 获取插件，连接你的免费 TTSWP 账户，在一个翻译版本上测试并试听效果，再决定是否推广到所有翻译版本。

相关文章