PyInstaller打包含Tkinter的Python程序后subprocess无法正常运行的问题

这个问题的核心在于无控制台GUI程序（.pyw打包的exe）与subprocess调用的交互冲突，再加上你在Tkinter主线程里执行阻塞式的subprocess.run，双重因素导致了进程挂起和空输出的问题。

为什么会出现这个问题？ #

• 无控制台环境的限制：.pyw打包成--onefile的exe后，程序运行时没有关联的控制台窗口。当你用shell=True调用dir这类CMD内置命令时，子进程（cmd.exe）可能因为缺少控制台上下文，无法正确处理输出流，甚至陷入等待状态。
• 主线程阻塞：Tkinter的mainloop依赖主线程处理GUI事件，你在按钮点击的回调里直接调用阻塞式的subprocess.run，会卡住整个GUI线程，同时子进程的IO操作也可能因为主线程阻塞无法完成。

具体修复方案 #

下面是几种可行的解决办法，按推荐程度排序：

1. 使用线程执行subprocess调用（最优解）

把subprocess的调用放到单独的线程里，既避免阻塞Tkinter主线程，也能解决无控制台环境的IO问题：

import tkinter as tk
import os
import subprocess
import threading

scriptpath = os.path.abspath(os.path.dirname(__file__))

def run_subprocess():
    # 明确用cmd.exe执行内置命令，避免shell=True的兼容性问题
    cmdlst = ["cmd.exe", "/c", "dir", "/w"]
    foutput = os.path.join(scriptpath, "result.txt")
    if os.path.exists(foutput):
        os.remove(foutput)
    # 同时重定向stderr，避免错误输出阻塞进程
    with open(foutput, "w") as fresult:
        try:
            subprocess.run(cmdlst, stdout=fresult, stderr=subprocess.STDOUT, text=True, shell=False)
        except Exception as e:
            # 可在这里添加错误提示，比如弹出Tkinter消息框
            with open(foutput, "a") as f:
                f.write(f"Error: {str(e)}")

def doit():
    # 启动守护线程执行子进程，不影响主程序退出
    threading.Thread(target=run_subprocess, daemon=True).start()

myDia = tk.Tk()
bt1 = tk.Button(myDia, text="DoIt", command=doit, width=16, height=2)
bt1.grid(row=0, column=0, sticky='W', padx=0, pady=0)
myDia.mainloop()

2. 打包时保留控制台（快速测试用）

如果你可以接受运行exe时弹出控制台窗口，可以修改PyInstaller命令：

pyinstaller --onefile --console subproc.pyw

这样子进程有了控制台上下文，shell=True的调用就能正常执行，但会弹出额外的控制台窗口，适合调试阶段使用。

3. 调整subprocess参数（需配合线程使用）

去掉shell=True，并明确调用cmd.exe来执行dir命令（因为dir是CMD内置命令，不是独立可执行文件）：

cmdlst = ["cmd.exe", "/c", "dir", "/w"]
subprocess.run(cmdlst, stdout=fresult, text=True, shell=False)

但这个方法如果还是在Tkinter主线程调用，依然会卡住GUI，所以最好还是配合线程使用。

关键注意点 #

• 永远不要在Tkinter的主线程里执行阻塞式操作（比如subprocess.run、长时间IO任务），否则GUI会失去响应，也容易引发各种IO阻塞问题。
• 对于无控制台的GUI程序，调用系统内置命令时，必须明确通过cmd.exe /c或者powershell.exe -Command来执行，不能直接调用命令名。

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