您尝试安装或激活 TTSWP 时遇到了问题。可能是安装失败、插件显示致命错误，或激活后菜单未出现。本页按从最常见到最少见的顺序介绍常见原因。
原因 1：PHP 版本过旧
症状： WordPress 拒绝激活插件，并显示类似「该插件需要 PHP 7.2 或更高版本」的错误，或在激活后立即出现白屏。
原因： TTSWP 需要 PHP 7.2 或更新版本。许多主机在旧账户上仍默认运行 PHP 7.0 或 7.1。
解决方法：
- 打开您的主机控制面板（cPanel、Plesk、SiteGround、Kinsta、WP Engine 等）。
- 找到 PHP 版本选择器（通常在「PHP Selector」或「Site Tools → PHP Manager」下）。
- 切换到 PHP 8.0 或更高版本。PHP 8.2 是目前推荐的版本。
- 重新尝试激活插件。
如果无法通过控制面板更改 PHP，请联系您的主机。2026 年几乎所有主机都支持 PHP 8.x。
原因 2：文件权限阻止上传
症状： 上传 zip 文件或从目录安装时显示「插件安装失败」或「无法创建目录」。
原因： 您的 wp-content/plugins/ 目录对 Web 服务器不可写。
解决方法：
- 通过 SFTP 或主机文件管理器连接到您的站点。
- 将
wp-content/plugins/权限设置为 755（某些主机为 775）。 - 将目录内的文件设置为 644。
- 重新尝试安装。
在许多托管主机（Kinsta、WP Engine、Pressable）上，文件管理器会自动处理此问题。如果您仍然遇到问题，请联系主机修复插件目录权限。
原因 3：激活时插件冲突
症状： 激活时抛出致命错误，提及函数名、类名或「Cannot redeclare」。在插件被停用之前站点可能无法访问。
原因： 另一个已激活的插件定义了同名函数或类（少见但可能发生），或安全插件阻止了激活。
解决方法：
- 通过 SFTP 将
wp-content/plugins/text-to-speech-tts/重命名为text-to-speech-tts.off，站点将恢复正常。 - 在插件 → 已安装插件中停用所有其他插件。
- 将 TTSWP 文件夹重命名回原来的名称。
- 先激活 TTSWP，然后逐一重新激活其他插件。在 TTSWP 激活状态下导致失败的插件即为冲突来源。
- 联系支持并告知冲突插件名称，我们将帮助找到解决方案。
原因 4：激活后文字转语音菜单缺失
症状： 插件在插件 → 已安装插件中显示为已激活，但管理侧边栏中没有文字转语音条目。
原因： 您的用户角色缺少 manage_options 权限，或安全插件移除了该菜单。
解决方法：
- 以管理员身份登录。编辑者及更低权限角色默认不显示 TTSWP 菜单。
- 如果您已经是管理员，请检查用户 → 个人资料，确认您的角色为管理员。
- 逐一禁用 iThemes Security、Wordfence 管理菜单隐藏或 Hide My WP 等安全插件，并重新加载后台。如果菜单重新出现，请将该插件配置为允许
text-to-speech-tts-settings。
原因 5：文章列表中缺少 TTS 列
症状： 插件正常运行，但文章 → 所有文章中未显示 TTS 列。
解决方法：
- 打开文章 → 所有文章。
- 点击页面右上角的显示选项。
- 勾选 TTS 复选框。
- 该列将显示出来。
如果复选框完全缺失，说明您的主题或其他插件将其过滤掉了。切换到默认主题（Twenty Twenty-Five）以确认。
原因 6：WordPress 版本过旧
症状： 插件安装失败，显示「您的站点不符合最低要求」。
原因： TTSWP 需要 WordPress 6.0 或更新版本。
解决方法： 在仪表盘 → 更新中更新 WordPress。如果无法更新，可能是您的主机将您保留在旧版本上，请联系主机进行更新。
原因 7：出站 HTTPS 被阻止
症状： 插件安装和激活正常，但概览页面显示「无法连接到 TTSWP 服务器」或连接按钮没有任何响应。
原因： 您的主机阻止了 PHP 向外部域名发出的出站 HTTPS 请求。这在真实主机上很少见，但在本地开发环境中较为常见。
解决方法：
- 在本地环境中，检查您的防火墙或 VPN。
- 在真实主机上，将
app.ttswp.com和*.ttswp.com添加到出站 HTTPS 允许列表中。 - 请参阅连接故障排查了解更深入的网络检查方法。
仍然无法解决？
如果以上方法均无效，请收集以下信息并联系支持：
- WordPress 版本（在仪表盘 → 概览中查看）
- PHP 版本（在工具 → 站点健康 → 信息 → 服务器中查看）
- 当前主题名称和版本
- 其他已激活插件的列表
- 您看到的具体错误信息，如有可能请附截图