Python文本转语音完全指南：从入门到实战

用Python让你的程序"开口说话"！支持中英文，5分钟上手 🚀

📋 目录

1. 什么是文本转语音？
2. 为什么选择 pyttsx3？
3. 安装教程
4. 快速上手
5. 进阶功能
6. 常见问题及解决方案
7. 完整实战案例
8. 总结

1️⃣ 什么是文本转语音？

文本转语音（Text-to-Speech, TTS）就是让计算机把文字读出来。

应用场景：

• 🤖 智能助手（如小爱同学、Siri）
• 📖 有声读物生成
• 🚗 车载导航语音播报
• &障碍辅助工具

Python 中最流行的 TTS 库是pyttsx3，它离线运行、跨平台、支持中英文！

2️⃣ 为什么选择 pyttsx3？

结论：离线 + 中文 + 可定制 → pyttsx3 是首选！🏆

3️⃣ 安装教程

✅ 步骤1：创建虚拟环境（推荐）

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

✅ 步骤2：安装 pyttsx3

pipinstallpyttsx3# 如果需要更好的兼容性，安装特定版本pipinstallpyttsx3==2.90

✅ 步骤3：安装 pypiwin32（Windows 必需）

pipinstallpypiwin32

4️⃣ 快速上手（5行代码）

importpyttsx3 engine=pyttsx3.init()engine.say("你好，世界！Hello World!")engine.runAndWait()

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

5️⃣ 进阶功能

🎚️ 1. 调整语速

importpyttsx3 engine=pyttsx3.init()# 获取当前语速rate=engine.getProperty('rate')print(f"当前语速:{rate}")# 默认 200# 设置语速（范围 50-300）engine.setProperty('rate',150)# 变慢engine.say("这是慢速语音")engine.runAndWait()

🔊 2. 调整音量

importpyttsx3 engine=pyttsx3.init()# 获取当前音量volume=engine.getProperty('volume')print(f"当前音量:{volume}")# 默认 1.0# 设置音量（范围 0.0 - 1.0）engine.setProperty('volume',0.8)# 80% 音量engine.say("这是80%音量的语音")engine.runAndWait()

🗣️ 3. 切换语音（中英文）

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

输出示例：

语音 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)

📝 4. 保存为音频文件

importpyttsx3 engine=pyttsx3.init()# 设置保存路径engine.save_to_file("你好，这是保存的音频","test.mp3")engine.runAndWait()print("✅ 音频已保存为 test.mp3")

6️⃣ 常见问题及解决方案 🔧

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

原因：Python 版本低于 3.8

解决：

# 方案A：升级 Python 到 3.8+# 方案B：降级 pyttsx3pipinstallpyttsx3==2.90

❌ 问题2：_ctypes.COMError: (-2147200966, None, ...)

原因：Windows 语音引擎找不到可用语音

解决：

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. 打开Windows 设置 → 时间和语言 → 语音
2. 点击“添加语音”
3. 搜索“Chinese”并安装
4. 重启电脑

7️⃣ 完整实战案例 🎬

🎯 案例1：智能朗读器（支持中英文切换）

importpyttsx3classTextToSpeech:def__init__(self):self.engine=pyttsx3.init()self.voices=self.engine.getProperty('voices')defset_chinese(self):"""切换到中文语音"""self.engine.setProperty('voice',self.voices[1].id)defset_english(self):"""切换到英文语音"""self.engine.setProperty('voice',self.voices[0].id)defset_speed(self,rate=150):"""设置语速"""self.engine.setProperty('rate',rate)defset_volume(self,volume=0.8):"""设置音量"""self.engine.setProperty('volume',volume)defspeak(self,text,lang='cn'):"""朗读文本"""iflang=='en':self.set_english()else:self.set_chinese()self.engine.say(text)self.engine.runAndWait()defsave(self,text,filename='output.mp3'):"""保存为音频文件"""self.engine.save_to_file(text,filename)self.engine.runAndWait()# 🚀 使用示例tts=TextToSpeech()tts.speak("你好，欢迎使用Python文本转语音！")tts.set_speed(120)tts.speak("This is English voice, slower speed.")tts.save("保存的音频测试","test.mp3")

🎯 案例2：批量朗读文本文件

importpyttsx3defread_file(filepath):engine=pyttsx3.init()engine.setProperty('voice',engine.getProperty('voices')[1].id)withopen(filepath,'r',encoding='utf-8')asf:text=f.read()engine.say(text)engine.runAndWait()# 使用read_file("article.txt")

8️⃣ 总结 📊

🎁 延伸学习

💬 互动话题

你用文本转语音做过什么有趣的项目？欢迎在评论区分享！👇

• 🤖 智能助手？
• 📖 有声读物生成器？
• 🎮 游戏语音播报？

觉得有用？点个 ⭐ Star 收藏吧！

有问题？评论区见！🚀

📝作者：Python学习笔记
📅更新时间：2024年
🔗源码地址：GitHub（示例代码）