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

 更新时间:2026年05月20日 08:13:29   作者:detayun  
本文介绍了如何使用Python的pyttsx3库实现文本转语音功能,主要内容包括pyttsx3的安装方法,5行代码快速实现语音播报以及保存音频文件和常见问题解决方案,有需要的小伙伴可以了解下

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

什么是文本转语音?

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

应用场景:

  • 智能助手(如小爱同学、Siri)
  • 有声读物生成
  • 车载导航语音播报
  • 障碍辅助工具

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

为什么选择 pyttsx3?

特性pyttsx3gTTSedge-tts
离线使用
支持中文
跨平台
自定义语音
速度⚡ 快🐢 慢(需联网)🐢 慢(需联网)

结论:离线 + 中文 + 可定制 → pyttsx3 是首选!

安装教程

步骤1:创建虚拟环境(推荐)

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

步骤2:安装 pyttsx3

pip install pyttsx3
# 如果需要更好的兼容性,安装特定版本
pip install pyttsx3==2.90

步骤3:安装 pypiwin32(Windows 必需)

pip install pypiwin32

快速上手(5行代码)

import pyttsx3

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

运行后,你的电脑就会说话了! 

进阶功能

1. 调整语速

import pyttsx3

engine = pyttsx3.init()

# 获取当前语速
rate = engine.getProperty('rate')
print(f"当前语速: {rate}")  # 默认 200

# 设置语速(范围 50-300)
engine.setProperty('rate', 150)  # 变慢
engine.say("这是慢速语音")
engine.runAndWait()
语速值效果
50🐢 极慢
150🚶 正常偏慢
200🏃 默认
300🚀 极快

2. 调整音量

import pyttsx3

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. 切换语音(中英文)

import pyttsx3

engine = pyttsx3.init()

# 查看所有可用语音
voices = engine.getProperty('voices')
for i, voice in enumerate(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. 保存为音频文件

import pyttsx3

engine = pyttsx3.init()

# 设置保存路径
engine.save_to_file("你好,这是保存的音频", "test.mp3")
engine.runAndWait()

print("✅ 音频已保存为 test.mp3")

常见问题及解决方案

问题1:SyntaxError: invalid syntax(海象运算符错误)

原因:Python 版本低于 3.8

解决

# 方案A:升级 Python 到 3.8+
# 方案B:降级 pyttsx3
pip install pyttsx3==2.90

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

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

解决

import pyttsx3

engine = pyttsx3.init()

# 🔑 关键:手动设置语音
voices = engine.getProperty('voices')
engine.setProperty('voice', voices[0].id)  # 使用第一个语音

engine.say("测试成功")
engine.runAndWait()

问题3:KeyError: None

原因:驱动初始化失败

解决

pip uninstall pyttsx3 -y
pip install pyttsx3==2.90
pip install pypiwin32

问题4:没有中文语音

解决

  1. 打开 Windows 设置 → 时间和语言 → 语音
  2. 点击 “添加语音”
  3. 搜索 “Chinese” 并安装
  4. 重启电脑

完整实战案例

案例1:智能朗读器(支持中英文切换)

import pyttsx3

class TextToSpeech:
    def __init__(self):
        self.engine = pyttsx3.init()
        self.voices = self.engine.getProperty('voices')
        
    def set_chinese(self):
        """切换到中文语音"""
        self.engine.setProperty('voice', self.voices[1].id)
        
    def set_english(self):
        """切换到英文语音"""
        self.engine.setProperty('voice', self.voices[0].id)
        
    def set_speed(self, rate=150):
        """设置语速"""
        self.engine.setProperty('rate', rate)
        
    def set_volume(self, volume=0.8):
        """设置音量"""
        self.engine.setProperty('volume', volume)
        
    def speak(self, text, lang='cn'):
        """朗读文本"""
        if lang == 'en':
            self.set_english()
        else:
            self.set_chinese()
        self.engine.say(text)
        self.engine.runAndWait()
        
    def save(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:批量朗读文本文件

import pyttsx3

def read_file(filepath):
    engine = pyttsx3.init()
    engine.setProperty('voice', engine.getProperty('voices')[1].id)
    
    with open(filepath, 'r', encoding='utf-8') as f:
        text = f.read()
    
    engine.say(text)
    engine.runAndWait()

# 使用
read_file("article.txt")

总结

知识点命令/代码
安装pip install pyttsx3==2.90
初始化engine = pyttsx3.init()
说话engine.say("文本")
执行engine.runAndWait()
语速engine.setProperty('rate', 150)
音量engine.setProperty('volume', 0.8)
切换语音engine.setProperty('voice', voices[0].id)
保存文件engine.save_to_file("文本", "file.mp3")

延伸学习

特点适用场景
pyttsx3离线、可定制桌面应用、嵌入式
gTTS联网、音质好在线服务、API
edge-tts微软语音、自然高质量语音生成
pyttsx4pyttsx3 改进版未来替代方案

到此这篇关于从入门到实战详解Python文本转语音的完全指南的文章就介绍到这了,更多相关Python文本转语音内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Python使用matplotlib模块绘制图像并设置标题与坐标轴等信息示例

    Python使用matplotlib模块绘制图像并设置标题与坐标轴等信息示例

    这篇文章主要介绍了Python使用matplotlib模块绘制图像并设置标题与坐标轴等信息,结合实例形式分析了Python中matplotlib模块进行坐标系图形绘制的相关操作技巧,需要的朋友可以参考下
    2018-05-05
  • python ip正则式

    python ip正则式

    python下的ip正则实现代码。
    2009-05-05
  • python批量修改文件编码格式的方法

    python批量修改文件编码格式的方法

    这篇文章主要为大家详细介绍了python批量修改文件编码格式的方法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-05-05
  • Python学习之基础语法介绍

    Python学习之基础语法介绍

    大家好,本篇文章主要讲的是Python学习之基础语法介绍,感兴趣的同学赶快来看一看吧,对你有帮助的话记得收藏一下,方便下次浏览
    2021-12-12
  • python生成excel的实例代码

    python生成excel的实例代码

    这篇文章主要为大家详细介绍了python生成excel的实例代码,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-11-11
  • 深入解析Python中占位符%的使用方法

    深入解析Python中占位符%的使用方法

    在Python中,%占位符是一种强大的工具,用于格式化字符串,本文将深入解析Python中占位符的使用方法,包括字符串格式化、数字格式化、日期格式化等多个方面,需要的可以参考下
    2023-12-12
  • python中pandas输出完整、对齐的表格的方法

    python中pandas输出完整、对齐的表格的方法

    今天使用python计算数据相关性,但是发现计算出的表格中间好多省略号,而且也不对齐。怎么解决这个问题,下面小编给大家带来了python中pandas如何输出完整、对齐的表格,感兴趣的朋友一起看看吧
    2021-10-10
  • Python中的元组(Tuple)操作实例详解

    Python中的元组(Tuple)操作实例详解

    Python 元组和列表很像,也是一个包含多个元素的集合,下面这篇文章主要给大家介绍了关于Python中元组(Tuple)操作的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2022-02-02
  • Python字符串匹配之6种方法的使用详解

    Python字符串匹配之6种方法的使用详解

    这篇文章主要介绍了Python字符串匹配之6种方法的使用详解,在文末给大家提到了python正则表达的说明,感兴趣的朋友跟随小编一起学习吧
    2019-04-04
  • Win10 安装PyCharm2019.1.1(图文教程)

    Win10 安装PyCharm2019.1.1(图文教程)

    这篇文章主要介绍了Win10 安装PyCharm2019.1.1(图文教程),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-09-09

最新评论