Ubuntu环境下Pyttsx3控制台可运行但脚本执行无法生成音频文件问题求助

我之前在Ubuntu上折腾pyttsx3的时候也碰到过一模一样的问题——控制台逐行敲代码能正常生成text.mp3，把代码放进脚本里跑，明明print("test")能正常输出，就是音频文件死活不出来，当时确实卡了好一会儿。结合我的排查经验，给你几个方向试试：

首先排查最容易忽略的：工作目录与路径问题 #

脚本执行时的工作目录不一定是你当前打开控制台的目录！比如你在~/projects下执行python3 script.py，但脚本如果放在~/scripts里，相对路径text.mp3会生成在~/projects而不是~/scripts里，你可能没注意到。

解决方法：

• 在脚本里加一行代码打印当前工作目录：

  import os
  print("当前工作目录：", os.getcwd())
  

• 直接用绝对路径保存音频，比如：

  engine.save_to_file(text, '/home/你的用户名/text.mp3')
  

  替换成你自己的用户名或者明确的文件夹路径，避免相对路径的坑。

其次检查pyttsx3的引擎初始化与驱动问题 #

交互式控制台会加载完整的用户环境，而脚本执行（尤其是非交互式shell）可能缺少音频相关的环境变量，导致pyttsx3无法正确初始化引擎——哪怕是save_to_file功能，底层也依赖音频驱动的初始化。

试试这几个办法：

1. 显式指定驱动初始化
   在Ubuntu上pyttsx3默认用espeak驱动，有时候脚本初始化时没自动识别到，手动指定试试：

   engine = pyttsx3.init(driverName='espeak')
   

2. 加载完整的用户环境执行脚本
   用交互式shell来运行脚本，这样会加载和控制台一样的环境变量：

   bash -i -c 'python3 script.py'
   

3. 手动设置音频环境变量
   如果上面的方法有用，说明是环境变量的问题，可以在脚本里手动设置PulseAudio的路径（先通过id -u查看你的用户ID，替换下面的1000）：

   import os
   os.environ['PULSE_SERVER'] = 'unix:/run/user/1000/pulse/native'
   

最后检查隐藏的异常与依赖 #

脚本没报错不代表没有异常，pyttsx3有些错误可能不会主动抛出，试试在脚本里加异常捕获：

import pyttsx3
try:
    engine = pyttsx3.init()
    voices = engine.getProperty("voices")[0]
    engine.setProperty('voice', voices)
    text = 'Your Text'
    engine.save_to_file(text, '/home/你的用户名/text.mp3')
    engine.runAndWait()
    print("音频文件已成功生成！")
except Exception as e:
    print(f"捕获到错误：{str(e)}")

如果输出错误提示，比如找不到espeak驱动，那就是依赖没装全，执行下面的命令补装：

sudo apt-get install espeak libespeak1 espeak-ng

内容的提问来源于stack exchange，提问作者Gruffer