如何在PyQt5 macOS应用中运行外部进程且避免崩溃？

嘿，我之前做PyQt5打包的时候也碰到过类似的子进程崩溃问题，结合你说的场景——未编译正常、编译后崩，大概率是打包后的路径依赖或者子进程流处理的问题，给你几个实际可行的排查和解决方向：

1. 先确认PDF转JPEG工具的路径问题 #

这是最常见的坑！未编译时你用的是系统环境里的工具（比如poppler的pdftoppm，或者ImageMagick的convert命令），但打包工具（比如PyInstaller）不会自动把这些外部依赖打包进去，而且编译后的GUI程序运行时，可能找不到系统默认路径里的工具。

解决方法：

• 把PDF转JPEG工具的二进制文件（比如poppler的pdftoppm.exe/convert.exe）和你编译后的程序放在同一个目录下，然后代码里用相对路径调用，避免依赖系统路径：

  import os
  from subprocess import run
  
  # 获取当前程序所在的绝对目录
  app_root = os.path.dirname(os.path.abspath(__file__))
  # 拼接工具的路径
  convert_tool_path = os.path.join(app_root, "pdftoppm.exe")  # 替换成你的工具名称
  # 执行转换命令
  run([convert_tool_path, "-jpeg", "input.pdf", "output_prefix"], check=True)
  

• 如果用PyInstaller打包，也可以通过--add-binary参数直接把工具打包到程序里，比如：

  pyinstaller --add-binary "C:\Program Files\poppler\bin\pdftoppm.exe;." your_app.py
  

  这样打包后，工具会自动出现在程序的运行目录里。

2. 处理子进程的输出/错误流阻塞 #

未编译时，终端会自动处理子进程的stdout和stderr，但编译成GUI程序后，这些流如果没有被正确处理，很容易导致程序挂起甚至崩溃。

解决方法：

• 调用subprocess.run()时，显式指定输出流的处理方式，比如把输出捕获到变量里，或者重定向到空设备：

  from subprocess import run, PIPE, DEVNULL
  
  # 方式1：捕获输出用于排查错误
  result = run(convert_command, stdout=PIPE, stderr=PIPE, text=True)
  if result.returncode != 0:
      # 可以把错误信息打印到日志或者弹窗提示
      print(f"PDF转JPEG失败: {result.stderr}")
  # 方式2：忽略输出，避免阻塞
  run(convert_command, stdout=DEVNULL, stderr=DEVNULL, check=True)
  

• 如果你用的是subprocess.Popen，一定要记得调用communicate()方法来处理流，不要让子进程的输出一直堆积。

3. 权限与环境变量问题（针对Linux/macOS） #

如果是在非Windows系统下，编译后的程序可能没有执行外部工具的权限，或者工具所在目录不在运行环境的PATH里。

解决方法：

• 给PDF转JPEG工具添加可执行权限：

  chmod +x /path/to/your/convert_tool
  

• 在代码里手动把工具所在目录添加到环境变量PATH中：

  import os
  from subprocess import run
  
  tool_dir = "/path/to/your/convert_tool_dir"
  os.environ["PATH"] += os.pathsep + tool_dir
  run(["pdftoppm", "-jpeg", "input.pdf", "output_prefix"], check=True)
  

快速排查小技巧 #

你可以先在编译后的程序所在目录下，打开终端手动执行PDF转JPEG的命令，如果命令能正常执行，那问题大概率出在代码的路径调用或者流处理上；如果命令执行失败，那就是工具本身的依赖缺失或者权限问题。

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