text-to-audio基于 gTTS 的文本转语音实战指南【免费下载链接】PythonMy Python Examples项目地址: https://gitcode.com/gh_mirrors/py/Python导读text-to-audio是当前仓库gh_mirrors/py/Python下的一个轻量级文本转语音TTS示例项目它使用 Google 的gttsGoogle Text To Speech模块将普通文本或本地文本文件转换成 mp3 音频并播放。读完本文你将掌握 gTTS 的安装与基本调用流程、直接文本转音频与文本文件批量转录两条完整实操路径以及gTTS类核心参数text、lang、slow的作用与调整方法可直接复用到新闻播报、学习资料听读等场景。项目结构与前置准备text-to-audio目录下的文件构成了一个最小可用的 TTS 工具集文件作用README.md项目说明与使用流程文档即本文所依据的关联文档main.py直接把字符串文本转换为 mp3 音频的示例脚本text-file-to-audio.py读取本地文本文件内容并转换为音频的示例脚本hello.txt供text-file-to-audio.py使用的示例文本文件requirements.txt依赖声明os与gTTS依赖声明见 requirements.txt核心依赖只有一个第三方库pip install gttsos是 Python 标准库模块用于脚本末尾调用系统命令播放音频无需单独安装。直接文本转音频核心流程README 中给出的第一个流程是「把字符串文本转成音频」对应源码 main.py。完整代码可运行、可直接复制from gtts import gTTS import os # Enter the text in string format which you want to convert to audio mytext Hello World!, this audio is created using GTTS module. # Specify the language in which you want your audio language en # Create an instance of gTTS class myobj gTTS(textmytext, langlanguage, slowFalse) # Method to create your audio file in mp3 format myobj.save(hello_world.mp3) print(Audio Saved) # This will play your audio file os.system(mpg321 welcome.mp3)整个流程在 README 中被拆分为 5 个清晰步骤与代码逐行对应初始化待转换文本main.py 的mytext变量将要朗读的内容以字符串形式赋值。初始化语言main.py 的language变量指定语音语言代码示例为en英语。创建gTTS类实例main.py 的myobj传入text、lang、slow三个关键参数。调用save()方法保存音频main.py传入目标文件名例如hello_world.mp3此时会在当前目录生成 mp3 文件。播放音频文件main.py通过os.system()调用外部播放器mpg321。核心参数解析gTTS构造函数在本示例中使用了三个参数理解它们有助于你调整生成效果参数示例值作用textHello World!待转换的文本内容支持任意字符串langen语音语言代码en为英语可替换为zh中文、fr法语等 gTTS 支持的语言slowFalse朗读速度控制False为正常语速True为慢速朗读save()方法接受一个文件名参数将合成好的音频写入该文件。示例中保存为hello_world.mp3该文件已存在于 text-to-audio/hello_world.mp3即脚本运行后的实际产物。播放环节的注意点源码使用os.system(mpg321 welcome.mp3)播放音频这里有两个需要注意的细节mpg321是 Linux 平台上的 mp3 播放器命令行工具需要系统预先安装在 macOS 可改用afplayWindows 可改用start或os.startfile()。源码中播放的是welcome.mp3与上一步保存的hello_world.mp3文件名不一致。若直接运行该脚本播放命令会因找不到文件而报错建议将播放命令中的文件名改为实际保存的文件名。这一点也印证了 README 末尾的约定——修改代码时应在 README 中同步记录保持文档与代码一致。文本文件转录为音频进阶流程README 给出的第二个流程是「把整个文本文件的内容转录为音频」适用于批量朗读长文本如文章、笔记、小说章节对应源码 text-file-to-audio.pyfrom gtts import gTTS import os # Enter the name of your text file mytextfile hello.txt # Specify the language in which you want your audio language en # Get the contents of your file with open(mytextfile, r) as f: mytext f.read() f.close() # Create an instance of gTTS class myobj gTTS(textmytext, langlanguage, slowFalse) # Method to create your audio file in mp3 format myobj.save(hello.mp3) print(Audio Saved) # This will play your audio file os.system(mpg321 hello.mp3)README 将流程拆为 6 步与代码逐行对应指定文本文件名text-file-to-audio.py 的mytextfile示例为hello.txt即目录内的 hello.txt。初始化语言text-file-to-audio.py 的language同样为en。读取文件内容text-file-to-audio.py使用with open(...) as f以只读模式打开文件将全部内容读入mytext变量with语句负责上下文管理文件会在块结束后自动关闭。创建gTTS类实例text-file-to-audio.py 的myobjtext参数传入上一步读取的文件内容。调用save()保存音频text-file-to-audio.py保存为hello.mp3。播放音频text-file-to-audio.py调用mpg321播放hello.mp3。与直接文本方案相比唯一的变化在于文本来源前者来自代码中的字符串常量后者来自外部.txt文件因此这套脚本可以无缝替换成任意本地文本文件如notes.txt、article.txt实现「文件级」的批量 TTS 转换。仓库中的延伸实践text-to-audio并非仓库中唯一使用 gTTS 的代码同一仓库内还有其他基于 gTTS 的实现可帮助你理解该模块的不同用法text_to_audio/main.py在基础示例之上做了工程化改进——将功能封装为userAudio类通过save_only()保存音频、play_only()使用BytesIO与pygame.mixer直接播放而不落盘并增加了tld参数如com以选择不同的 Google TTS 域名/口音其 README.md 记录了惰性加载lazy loading、按需导入以优化内存等改进点。JARVIS/speech.py 与 JARVIS/JARVIS_2.0.py将 gTTS 集成进语音助手项目作为语音输出TTS 播报环节。这印证了 README 中的说明gTTS是项目采用的统一转换模块从最简单的两行脚本到类封装、再到完整的语音助手都是围绕同一个gTTS核心展开的。常见问题与使用建议语言代码如何选gTTS 支持的语言代码遵循 ISO 639-1 风格如en、zh、hi、es中文朗读可把language改为zh。语速如何调slowFalse为正常语速改为True可获得更慢、更清晰的朗读适合语言学习场景。长文本注意gTTS 依赖网络调用 Google 文本转语音服务超长文本建议分段转换后再拼接避免单次请求过大。播放器兼容性mpg321仅限 Linux跨平台使用时需按上文替换为对应系统的播放命令。总结text-to-audio用不到 30 行代码演示了 gTTS 文本转语音的完整闭环gTTS(text..., lang..., slow...)创建实例 →save()落盘 mp3 → 系统命令播放。无论是直接转字符串还是读取 hello.txt 这类文本文件批量转录两条流程都清晰可复用配合仓库内 text_to_audio 的类封装版本你还能进一步掌握参数扩展tld口音与不落盘播放等进阶技巧。【免费下载链接】PythonMy Python Examples项目地址: https://gitcode.com/gh_mirrors/py/Python创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
