Python 文本转语音实现指南：使用 pyttsx3 库

输出示例可能包含中文（如 Microsoft Huihui）或英文（如 Microsoft Zira）语音包。

2. 设置语速和音量

默认情况下，语速和音量可能不符合预期。可以通过 getProperty 获取当前值，再使用 setProperty 进行调整。

import pyttsx3 

engine = pyttsx3.init()

# 获取当前语速
rate = engine.getProperty('rate')
# 增加语速 (例如增加 50)
engine.setProperty('rate', int(rate) + 50)

# 获取当前音量 (范围 0.0 到 1.0)
volume = engine.getProperty('volume')
# 增加音量
engine.setProperty('volume', float(volume) + 0.25)

# 播放测试
engine.say("现在语速较快，音量较大")
engine.runAndWait()
engine.stop()

保存语音为文件

除了实时播放，pyttsx3 还支持将语音保存为音频文件（如 MP3），方便后续分发或存储。

1. 保存字符串

import pyttsx3 

engine = pyttsx3.init()
str_text = "这是一段保存的语音内容"

engine.save_to_file(str_text, 'output.mp3')
engine.runAndWait()
engine.stop()

2. 读取文件并转换

在实际应用中，常需要将文本文件的内容转换为语音。

import pyttsx3 

engine = pyttsx3.init()

try:
    # 打开文本文件，指定编码以防乱码
    with open("input.txt", "r", encoding="utf-8") as f:
        text_content = f.read()
    
    engine.save_to_file(text_content, 'audio_output.mp3')
    engine.runAndWait()
    print("转换完成")
except FileNotFoundError:
    print("未找到输入文件")
except Exception as e:
    print(f"发生错误：{e}")
finally:
    engine.stop()

方案对比与注意事项

1. 离线 vs 在线

• pyttsx3: 完全离线，依赖本地系统语音引擎。优点是隐私性好、无网络延迟；缺点是音质受限于操作系统，无法定制个性化声音。
• gTTS / Azure TTS: 在线服务，需要网络连接。优点是音质自然、可选择多种音色；缺点是需要 API Key 或网络环境。

2. 线程安全

在 GUI 应用（如 Tkinter, PyQt）中使用 runAndWait() 可能会导致界面卡死。建议在后台线程中处理语音播放：

import threading

def speak_thread(text):
    engine = pyttsx3.init()
    engine.say(text)
    engine.runAndWait()

threading.Thread(target=speak_thread, args=("后台播放测试",)).start()

总结

本文详细介绍了如何使用 Python 的 pyttsx3 库实现文本转语音功能。通过初始化引擎、配置属性、保存文件等操作，开发者可以快速构建具备语音交互能力的应用。对于不需要极高音质的场景，pyttsx3 是一个轻量且高效的解决方案。