Windows双击.pyw文件GUI无法启动的原因及调试方法

• Windows下.pyw格式默认由pythonw.exe启动，和python.exe的区别是运行时不会常驻CMD控制台窗口，一旦脚本启动阶段抛出未捕获的异常，进程会直接退出，就会出现你看到的「CMD闪一下就关、GUI弹不出来」的现象。
• 你提到的部分pyw能正常运行、部分不行，已经可以排除系统层面Python环境变量、文件关联的全局故障，问题只会出在三个地方：
  • 故障pyw指向的目标.py脚本本身存在语法错误、运行时异常
  • 故障pyw是快捷方式类型，启动参数/工作目录配置错误，导致脚本运行时找不到同项目的依赖文件、资源文件
  • 故障pyw指向的脚本依赖的特定库、资源缺失，和能正常运行的脚本依赖环境不匹配
• 你查看属性发现pyw指向内部.py文件，说明这些不是原生pyw源码文件，是项目作者创建的快捷方式入口，这类文件非常容易出现「起始位置未配置」的低级错误——双击时程序的工作目录是快捷方式所在目录，不是脚本所在目录，所有写了相对路径的资源加载都会直接失败抛错。

按顺序操作，不要跳步：

1. 先抓真实报错，这是解决问题的核心前提
   • 右键点击无法启动的pyw文件，选「属性」，复制「目标」栏里标注的.py文件完整路径，比如D:\myapp\login.py
   • 按下Win+R输入cmd敲回车打开命令提示符，直接输入命令python 你刚才复制的py文件完整路径，敲回车运行
   • 此时窗口不会自动关闭，脚本运行的所有输出、报错信息会完整停留在窗口里，根据报错直接对应解决：
     • 报ModuleNotFoundError: No module named 'xxx'：缺少对应的第三方依赖库，执行pip install xxx安装对应版本即可
     • 报FileNotFoundError: xxx file not found：脚本加载资源/依赖文件失败，绝大多数情况是快捷方式的工作目录配置错误
     • 报SyntaxError：源码语法和你安装的Python3.5版本不兼容，比如用了Python3.6+才支持的f-string、3.10+才支持的match语法，需要换对应版本的Python，或者修改源码兼容
2. 修复快捷方式配置错误
   • 打开故障pyw的属性页，找到「起始位置」栏，填入对应.py文件所在的文件夹完整路径，比如目标是D:\myapp\login.py，起始位置就填D:\myapp\，不要留空
   • 配置完成后点确定保存，再双击pyw测试即可，可以直接抄能正常运行的pyw的配置规则，只替换目标栏的脚本路径即可
3. 验证系统pyw关联是否正常
   • 新建一个文本文件，写入以下代码：

     from tkinter import Tk
     root = Tk()
     root.title("test")
     root.mainloop()
     

   • 把文件改名为test.pyw存到桌面，双击运行，如果能正常弹出空白GUI窗口，说明系统层面的pyw文件关联、pythonw.exe运行完全正常，不需要重装Python或者修改全局环境配置。

如果按上述步骤拿到了具体报错信息，可以补充对应报错内容和相关源码段，即可精确定位问题。

内容的提问来源于stack exchange，提问作者Tester two DS