使用QProcess运行Python脚本无法实时输出结果到textEdit如何解决

前置校验 #

先手动拼接完整的运行命令在系统终端执行，确认命令本身可正常运行、有预期输出，排除脚本不存在、参数错误、脚本本身无输出等问题。 #

核心问题修复 #

• 修正路径拼接逻辑
  1. Python解释器路径直接使用sys.executable获取，无需手动拼接，避免Windows下遗漏.exe后缀或路径错误
  2. 脚本路径拼接无需额外添加os.sep前缀，os.path.join会自动适配系统路径分隔符，修改为：

  cmd = os.path.join(b, 'python', 'plugins', 'totalopenstationToQgis', 'scripts', 'totalopenstation-cli-parser.py')
  

• 禁用Python输出缓冲
  Python默认开启标准输出缓冲，未刷新缓冲区时不会实时输出内容，启动时添加-u参数禁用缓冲：

  # start方法的参数列表开头添加'-u'
  self.process.start(p, ['-u', cmd, '-i',str(self.lineEdit_input.text()),'-o',str(self.lineEdit_output.text()),'-f',self.comboBox_format.currentText(),'-t',self.comboBox_format2.currentText(),'--overwrite'])
  

• 合并标准流避免遗漏输出
  脚本报错信息会输出到标准错误流，默认readyRead仅监听标准输出，添加配置合并两路输出：

  # 在start调用前添加
  self.process.setProcessChannelMode(QProcess.MergedChannels)
  

• 修正输出解码逻辑
  readAll()返回QByteArray类型，直接转字符串会保留二进制前缀，需先转字节再解码：

  def dataReady(self):
      cursor = self.textEdit.textCursor()
      cursor.movePosition(cursor.End)
      output = bytes(self.process.readAll()).decode('utf-8', errors='replace')
      cursor.insertText(output)
      self.textEdit.ensureCursorVisible()
  

可选：添加异常监听快速定位问题 #

添加进程错误、结束信号监听，可快速排查启动失败、运行报错等问题：

# 放在start调用前
self.process.errorOccurred.connect(lambda err: print("进程启动错误码：", err))
self.process.finished.connect(lambda code, status: print("进程运行结束，退出码：", code))

修改后完整代码片段 #

import sys
import os
from PyQt5 import QtWidgets
from qgis.core import QgsApplication
from PyQt5.QtCore import QProcess

class TotalopenstationDialog(QtWidgets.QDialog, FORM_CLASS):

    def __init__(self, parent=None):
        """Constructor."""
        super(TotalopenstationDialog, self).__init__(parent)
        self.setupUi(self)

    def dataReady(self):
        cursor = self.textEdit.textCursor()
        cursor.movePosition(cursor.End)
        output = bytes(self.process.readAll()).decode('utf-8', errors='replace')
        cursor.insertText(output)
        self.textEdit.ensureCursorVisible()

    def callProgram(self):
        # 直接获取当前Python解释器完整路径
        p = sys.executable
        b=QgsApplication.qgisSettingsDirPath().replace("/","\\")
        # 修正路径拼接
        cmd = os.path.join(b, 'python', 'plugins', 'totalopenstationToQgis',
        'scripts', 'totalopenstation-cli-parser.py')
        self.process = QProcess(self)
        # 合并标准输出和标准错误流
        self.process.setProcessChannelMode(QProcess.MergedChannels)
        # 绑定信号
        self.process.readyRead.connect(self.dataReady)
        # 可选：添加错误和结束信号监听
        self.process.errorOccurred.connect(lambda err: print("进程启动错误：", err))
        self.process.finished.connect(lambda code, status: print("进程结束，退出码：", code))
        # 添加-u参数禁用缓冲
        self.process.start(p, [
            '-u', 
            cmd, 
            '-i',str(self.lineEdit_input.text()),
            '-o',str(self.lineEdit_output.text()),
            '-f',self.comboBox_format.currentText(),
            '-t',self.comboBox_format2.currentText(),
            '--overwrite'
        ])

    def on_pushButton_connect_pressed(self):
        self.callProgram()

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