pyttsx3

环境要求

• Python 3 环境（README 示例均使用 python3 语法）
• 已配置可用的 pip 包管理工具
• Linux 系统需要系统级语音引擎 espeak-ng 与 libespeak1
• macOS 上若 init() 报 pyobjc 相关错误，需 pyobjc>=9.0.1

安装与启动步骤

1. 1升级 wheel 工具

   如果安装 pyttsx3 时报错，先升级 wheel 版本再重新安装，可解决大部分构建类报错。

   pip install --upgrade wheel

   复制

2. 2安装 pyttsx3

   通过 pip 从 PyPI 安装，命令执行成功即完成安装，无需下载额外的大型模型或依赖。

   pip install pyttsx3

   复制

3. 3安装系统语音引擎

   仅 Linux 用户且遇到语音输出无声时需要执行，安装 espeak-ng 与 libespeak1 作为底层引擎。

   sudo apt update && sudo apt install espeak-ng libespeak1

   复制

4. 4运行最小示例

   创建 Python 脚本调用 init() 初始化引擎，再 say() 朗读文本并由 runAndWait() 阻塞等待播报完成。

   import pyttsx3
   engine = pyttsx3.init()
   engine.say("I will speak this text")
   engine.runAndWait()

   复制

5. 5单行朗读测试

   用 speak 函数一行代码即可用默认语音、语速和音量播报文本，适合快速验证环境是否正常。

   import pyttsx3
   pyttsx3.speak("I will speak this text")

   复制

6. 6保存语音为文件

   用 save_to_file 把朗读内容写入音频文件，再调用 runAndWait() 才会真正生成文件；Linux 需已装 espeak-ng。

   import pyttsx3
   engine = pyttsx3.init()
   engine.save_to_file('Hello World', 'test.mp3')
   engine.runAndWait()

   复制

如何确认成功

运行示例脚本后能听到语音播报；执行 save_to_file 示例后当前目录下生成 test.mp3 文件，即表示成功。

常见问题

注意事项

• pyttsx3 是 Python 库而非独立服务，没有端口和后台进程，直接在代码中 import 使用。
• 语音音色、语速、音量取决于操作系统已安装的语音包，不同平台可用声音不同。
• 调用 say() 或 save_to_file() 后必须执行 runAndWait()，否则不会播报或生成文件。