pyttsx3 完整使用说明：让Python开口说话

从安装到实战，一篇搞定！支持中英文，附完整代码示例 🎯

📖 目录

1. pyttsx3 是什么？
2. 安装步骤
3. 快速开始（3行代码）
4. 核心参数详解
5. 进阶功能
6. 完整实战案例
7. 常见错误及解决方案
8. 总结速查表

1️⃣ pyttsx3 是什么？

pyttsx3是 Python 最流行的离线文本转语音（TTS）库。

✨ 核心特点

2️⃣ 安装步骤

📦 方式1：pip 安装（推荐）

# 基础安装pipinstallpyttsx3# Windows 用户额外安装（必须！）pipinstallpypiwin32# 如果遇到版本问题，使用稳定版pipinstallpyttsx3==2.90

📦 方式2：虚拟环境安装（最佳实践）

# 创建虚拟环境python-mvenv tts_env# 激活环境# Windows:tts_env\Scripts\activate# Mac/Linux:sourcetts_env/bin/activate# 安装pipinstallpyttsx3 pypiwin32

✅ 验证安装

importpyttsx3print(pyttsx3.__version__)# 应输出 2.90 或更高

3️⃣ 快速开始（3行代码）

importpyttsx3 engine=pyttsx3.init()engine.say("Hello, 我是Python！")engine.runAndWait()

运行后，你的电脑就会说话了！🎉

4️⃣ 核心参数详解 🎛️

🔊 参数1：调整音量（0.0 ~ 1.0）

importpyttsx3 engine=pyttsx3.init()# 查看当前音量volume=engine.getProperty('volume')print(f"当前音量:{volume}")# 默认 1.0# 设置音量（0.0 = 静音，1.0 = 最大）engine.setProperty('volume',0.5)# 50% 音量engine.say("这是半音量的语音")engine.runAndWait()

🎚️ 参数2：调整语速（50 ~ 300）

importpyttsx3 engine=pyttsx3.init()# 查看当前语速rate=engine.getProperty('rate')print(f"当前语速:{rate}")# 默认 200# 设置语速engine.setProperty('rate',150)# 变慢engine.say("这是慢速语音")engine.runAndWait()engine.setProperty('rate',250)# 变快engine.say("这是快速语音")engine.runAndWait()

🗣️ 参数3：切换语音（中英文）

importpyttsx3 engine=pyttsx3.init()# 查看所有可用语音voices=engine.getProperty('voices')fori,voiceinenumerate(voices):print(f"[{i}]{voice.name}")print(f" ID:{voice.id}\n")# 切换到中文语音（通常索引为 1）engine.setProperty('voice',voices[1].id)engine.say("你好，这是中文语音")engine.runAndWait()# 切换到英文语音（通常索引为 0）engine.setProperty('voice',voices[0].id)engine.say("Hello, this is English")engine.runAndWait()

输出示例（Windows）：

[0] Microsoft David ID: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Speech\Voices\Tokens\TTS_MS_EN-US_DAVID_11.0 [1] Microsoft Huihui ID: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Speech\Voices\Tokens\TTS_MS_ZH-CN_HUIHUI_11.0

5️⃣ 进阶功能 🚀

💾 功能1：保存为音频文件

importpyttsx3 engine=pyttsx3.init()# 保存为 MP3 文件engine.save_to_file("你好，这是保存的音频","output.mp3")engine.runAndWait()print("✅ 音频已保存到 output.mp3")

🔄 功能2：暂停和继续

importpyttsx3 engine=pyttsx3.init()engine.say("这是第一句")engine.runAndWait()engine.say("这是第二句")engine.runAndWait()# 暂停engine.stop()# 继续（需要重新初始化）engine=pyttsx3.init()engine.say("这是第三句")engine.runAndWait()

📝 功能3：批量朗读文本

importpyttsx3defread_text(text,lang='cn'):engine=pyttsx3.init()voices=engine.getProperty('voices')engine.setProperty('voice',voices[1].idiflang=='cn'elsevoices[0].id)engine.setProperty('rate',150)engine.say(text)engine.runAndWait()# 批量朗读texts=["第一句：Python真好用","第二句：文本转语音太酷了","第三句：Hello World"]fortextintexts:read_text(text)

6️⃣ 完整实战案例 🎬

🎯 案例1：智能语音助手类

importpyttsx3classVoiceAssistant:def__init__(self):self.engine=pyttsx3.init()self.voices=self.engine.getProperty('voices')defspeak(self,text,lang='cn',rate=150,volume=0.8):"""通用朗读方法"""# 设置语音voice_id=self.voices[1].idiflang=='cn'elseself.voices[0].idself.engine.setProperty('voice',voice_id)# 设置参数self.engine.setProperty('rate',rate)self.engine.setProperty('volume',volume)# 朗读self.engine.say(text)self.engine.runAndWait()defspeak_cn(self,text):"""中文朗读"""self.speak(text,lang='cn')defspeak_en(self,text):"""英文朗读"""self.speak(text,lang='en')defsave_audio(self,text,filename):"""保存音频"""self.engine.save_to_file(text,filename)self.engine.runAndWait()# 🚀 使用示例assistant=VoiceAssistant()assistant.speak_cn("你好，我是你的智能语音助手！")assistant.speak_en("Hello, I am your voice assistant!")assistant.save_audio("测试保存","test.mp3")

🎯 案例2：阅读器（朗读文本文件）

importpyttsx3defread_file(filepath,lang='cn'):"""朗读文本文件"""try:withopen(filepath,'r',encoding='utf-8')asf:text=f.read()engine=pyttsx3.init()voices=engine.getProperty('voices')voice_id=voices[1].idiflang=='cn'elsevoices[0].idengine.setProperty('voice',voice_id)engine.setProperty('rate',150)engine.say(text)engine.runAndWait()print(f"✅ 已朗读文件:{filepath}")exceptFileNotFoundError:print(f"❌ 文件不存在:{filepath}")# 使用read_file("article.txt",lang='cn')

🎯 案例3：语音闹钟

importpyttsx3importtimedefvoice_alarm(hour,minute,message):"""语音闹钟"""engine=pyttsx3.init()engine.setProperty('rate',180)engine.setProperty('volume',1.0)whileTrue:now=time.localtime()ifnow.tm_hour==hourandnow.tm_min==minute:engine.say(f"闹钟响了！{message}")engine.runAndWait()breaktime.sleep(30)# 每30秒检查一次# 设置早上7:30的闹钟voice_alarm(7,30,"起床啦！新的一天开始了！")

7️⃣ 常见错误及解决方案 🔧

❌ 错误1：SyntaxError: invalid syntax（海象运算符）

原因：Python 版本 < 3.8

解决：

pipinstallpyttsx3==2.90

❌ 错误2：_ctypes.COMError: (-2147200966, ...)

原因：找不到可用语音

解决：

importpyttsx3 engine=pyttsx3.init()# 🔑 关键：手动设置语音voices=engine.getProperty('voices')engine.setProperty('voice',voices[0].id)engine.say("测试成功")engine.runAndWait()

❌ 错误3：KeyError: None

原因：驱动初始化失败

解决：

pip uninstall pyttsx3-ypipinstallpyttsx3==2.90pipinstallpypiwin32

❌ 错误4：没有中文语音

解决：

1. Win + I→ 时间和语言 → 语音
2. 点击“添加语音”
3. 搜索“Chinese”并安装
4. 重启电脑

8️⃣ 总结速查表 📊

🎁 延伸推荐

💬 互动话题

你用 pyttsx3 做过什么有趣的项目？

• 🤖 智能助手？
• 📖 有声读物？
• ⏰ 语音闹钟？

欢迎评论区分享！👇

📝作者：Python学习笔记
📅更新时间：2024年
⭐觉得有用？点个 Star 收藏吧！

有问题？评论区见！🚀