Windows环境下如何在PySide6应用中嵌入终端？

核心实现思路 #

Linux平台可借助X11窗口嵌入机制，直接将urxvt终端嵌入Qt容器；Windows平台则需要通过Windows API获取终端进程的窗口句柄，再将其绑定到Qt的QWidget容器中，实现嵌入效果。

完整代码实现 #

import sys
import os
from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout
from PySide6.QtCore import QProcess, QThread
import platform

class TerminalEmbedder(QWidget):
    def __init__(self):
        super().__init__()
        self.layout = QVBoxLayout(self)
        self.process = QProcess(self)
        self.terminal_container = QWidget()
        self.layout.addWidget(self.terminal_container)

        if platform.system() == "Linux":
            self._setup_linux_terminal()
        elif platform.system() == "Windows":
            self._setup_windows_terminal()
        else:
            raise NotImplementedError(f"Unsupported platform: {platform.system()}")

        self.setWindowTitle("Embedded Terminal")
        self.resize(800, 600)

    def _setup_linux_terminal(self):
        # 获取Qt容器的X11窗口ID
        container_win_id = self.terminal_container.winId()
        # 启动urxvt并嵌入到容器内
        self.process.start("urxvt", ["-embed", str(container_win_id)])

    def _setup_windows_terminal(self):
        # 可选：替换为"cmd.exe"使用命令提示符
        terminal_exe = "powershell.exe"
        # 启动终端并隐藏初始独立窗口
        startup_args = ["-NoExit", "-WindowStyle", "Hidden"]
        self.process.start(terminal_exe, startup_args)
        
        # 等待进程启动，确保窗口已创建
        self.process.waitForStarted()
        QThread.msleep(500)

        # 导入Windows API工具
        import ctypes
        from ctypes import wintypes
        user32 = ctypes.WinDLL('user32', use_last_error=True)

        # 定义API参数类型
        HWND = wintypes.HWND
        DWORD = wintypes.DWORD
        BOOL = wintypes.BOOL

        user32.GetWindowThreadProcessId.restype = DWORD
        user32.GetWindowThreadProcessId.argtypes = [HWND, wintypes.LPDWORD]
        user32.SetParent.restype = HWND
        user32.SetParent.argtypes = [HWND, HWND]
        user32.ShowWindow.restype = BOOL
        user32.ShowWindow.argtypes = [HWND, int]
        user32.MoveWindow.restype = BOOL
        user32.MoveWindow.argtypes = [HWND, int, int, int, int, BOOL]

        # 枚举窗口，匹配终端进程PID
        target_pid = self.process.processId()
        terminal_hwnd = None

        def enum_window_callback(hwnd, lparam):
            nonlocal terminal_hwnd, target_pid
            window_pid = DWORD()
            user32.GetWindowThreadProcessId(hwnd, ctypes.byref(window_pid))
            if window_pid.value == target_pid:
                terminal_hwnd = hwnd
                return False
            return True

        EnumWindowsProc = ctypes.WINFUNCTYPE(BOOL, HWND, wintypes.LPARAM)
        user32.EnumWindows(EnumWindowsProc(enum_window_callback), 0)

        if terminal_hwnd:
            # 将终端窗口绑定到Qt容器
            container_hwnd = self.terminal_container.winId()
            user32.SetParent(terminal_hwnd, HWND(container_hwnd))
            user32.ShowWindow(terminal_hwnd, 1)  # 显示终端窗口
            # 绑定窗口大小同步逻辑
            self.terminal_container.resizeEvent = lambda e: self._adjust_terminal_size(terminal_hwnd)

    def _adjust_terminal_size(self, hwnd):
        import ctypes
        from ctypes import wintypes
        user32 = ctypes.WinDLL('user32', use_last_error=True)
        client_rect = wintypes.RECT()
        user32.GetClientRect(self.terminal_container.winId(), ctypes.byref(client_rect))
        user32.MoveWindow(hwnd, 0, 0, client_rect.right, client_rect.bottom, True)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = TerminalEmbedder()
    window.show()
    sys.exit(app.exec())

关键细节说明 #

• Linux端：复用你已验证的urxvt -embed方案，直接将终端嵌入Qt容器的X11窗口。
• Windows端：
  1. 启动终端时用-WindowStyle Hidden避免弹出独立窗口；
  2. 通过EnumWindows枚举系统窗口，匹配终端进程PID获取窗口句柄；
  3. 调用SetParent将终端窗口挂载到Qt容器，实现嵌入；
  4. 重写容器的resizeEvent，调用MoveWindow让终端窗口随容器同步缩放。
• 切换终端类型：若需使用cmd.exe，只需将terminal_exe改为"cmd.exe"，启动参数替换为["/k", "echo Embedded CMD"]（/k用于保持窗口不退出）。

常见问题修复 #

• Windows下终端窗口查找失败：可适当延长QThread.msleep的等待时间，确保终端窗口完全创建后再进行枚举。
• 终端样式适配：若使用Windows Terminal，可将启动命令改为wt.exe，但需调整窗口查找逻辑（Windows Terminal的主窗口PID可能和启动进程不一致，需通过窗口标题匹配）。

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