几行代码就能让冰冷的文字变成生动的语音——这就是gTTS的魔力。一、什么是gTTSgTTSGoogle Text-to-Speech是一款基于Google翻译TTS API的Python开源库它能将任意文本转换为自然流畅的语音并保存为MP3文件。核心优势一览特性说明 多语言支持覆盖全球100种语言和方言⚡ 极简使用几行代码即可完成语音合成 完全免费无需付费享受Google语音合成技术 口音定制支持不同地区的本地化发音️ 语速可调支持正常/慢速两档切换二、安装一键搞定打开终端执行以下命令pipinstallgTTS如果你想从源码安装gitclone https://gitcode.com/gh_mirrors/gt/gTTScdgTTS pipinstall.环境要求 Python 3.7稳定的网络连接需要访问Google服务三、快速上手你的第一条语音3.1 Python方式推荐fromgttsimportgTTS# 创建语音对象ttsgTTS(text你好欢迎来到文本转语音的世界,langzh-CN)# 保存为MP3文件tts.save(hello.mp3)print(✅ 语音文件已生成hello.mp3)运行后当前目录下就会出现一个hello.mp3文件——就是这么简单3.2 命令行方式更快不想写代码直接用命令行gtts-cli你好世界--langzh-CN--outputhello.mp3还可以从文件读取文本gtts-cli-ftextfile.txt--outputspeech.mp3查看所有支持的语言gtts-cli--all四、进阶玩法解锁gTTS的隐藏技能 技能一多语言混合合成想让一段音频里既有中文又有英文轻松实现fromgttsimportgTTS tts_engTTS(Hello, welcome!,langen)tts_zhgTTS(你好欢迎使用语音合成,langzh-CN)withopen(mixed.mp3,wb)asf:tts_en.write_to_fp(f)tts_zh.write_to_fp(f) 技能二语速调节# 正常语速tts_normalgTTS(这是正常语速,langzh-CN,slowFalse)# 慢速播放适合教学场景语速约慢30%tts_slowgTTS(这是慢速播放,langzh-CN,slowTrue)tts_slow.save(slow_speech.mp3) 技能三地区口音定制重磅功能这是gTTS最强大的特性之一通过调整tld参数可以获取不同地区的发音特色语言/口音语言代码推荐tld英语美国enus英语英国enco.uk英语澳大利亚encom.au法语法国frfr法语加拿大frca葡萄牙语巴西ptcom.br西班牙语墨西哥escom.mx# 英式英语tts_ukgTTS(Hello world,langen,tldco.uk)tts_uk.save(hello_uk.mp3)# 美式英语tts_usgTTS(Hello world,langen,tldus)tts_us.save(hello_us.mp3)小技巧 不指定tld时默认使用com系统会根据你的网络位置自动选择最匹配的地区口音。在中国使用en语言代码通常会得到美式英语发音。 技能四流式处理内存友好对于内存敏感的场景使用BytesIO进行流式处理fromgttsimportgTTSfromioimportBytesIO mp3_fpBytesIO()ttsgTTS(Hello world,langen)tts.write_to_fp(mp3_fp)# 此时mp3_fp包含音频数据可直接传递给播放器audio_datamp3_fp.getvalue()如果想直接播放需安装pydub和ffmpegfrompydubimportAudioSegmentfrompydub.playbackimportplay mp3_fp.seek(0)audioAudioSegment.from_file(mp3_fp,formatmp3)play(audio)五、实战应用场景场景示例代码 有声读物gTTS(text章节内容, langzh-CN).save(fchapter_{i}.mp3) 教育应用gTTS(text单词, langen, slowTrue).save(word.mp3)♿ 无障碍工具为视障用户提供文本转语音功能 语音助手为Python应用添加语音反馈️ 播客制作批量转换文本为音频片段批量处理长文本当处理长篇文本时建议分段处理以获得更好的语音效果deftext_to_speech_long(text,filename,langzh-CN):paragraphstext.split(\n\n)withopen(filename,wb)asf:forparagraphinparagraphs:ifparagraph.strip():ttsgTTS(textparagraph,langlang)tts.write_to_fp(f)六、常用语言代码速查表语言代码语言代码中文简体zh-CN日语ja中文繁体zh-TW韩语ko英语en德语de西班牙语es法语fr俄语ru葡萄牙语pt意大利语it阿拉伯语ar完整语言列表可通过from gtts.lang import tts_langs; print(tts_langs())获取。七、故障排除指南 问题解决方案音频文件无法播放确认文件扩展名为.mp3检查播放器是否支持MP3格式语音生成失败验证文本非空检查语言代码是否正确安装失败确保Python≥3.7检查网络连接可尝试国内镜像源某种语言不工作查看gtts/langs.py确认是否支持或使用--nocheck跳过验证请求被屏蔽设置代理tts.save(out.mp3, proxies{http: http://ip:port})八、gTTS vs 其他TTS方案方案特点适用场景gTTS免费、多语言、在线个人项目、快速原型pyttsx3离线、跨平台无网络环境、系统集成Edge TTS微软免费TTS、神经语音高质量语音需求Google Cloud TTS付费、稳定商业应用、高并发Amazon PollyAWS高质量TTS企业级应用九、最佳实践建议 ✅网络优先 gTTS依赖Google服务确保网络可访问相关域名异常处理 务必用try-except包裹网络请求批量优化 复用gTTS实例减少网络请求次数文本预处理 gTTS内置智能分词器但长文本仍建议手动分段商用谨慎 免费版有请求频率限制商业用途建议使用官方API写在最后gTTS用最简洁的方式架起了文字与声音之间的桥梁。无论你是想给应用加个语音提示还是制作有声读物它都是最快上手的选择。记住实践是最好的老师。现在就打开终端输入pip install gTTS让你的代码开口说话吧 项目地址https://gitcode.com/gh_mirrors/gt/gTTS许可证MIT License