最常见原因是打包时漏加 -w 或 --noconsole 参数，PyInstaller 默认将脚本视为控制台程序并分配 console 子系统；Tkinter GUI 程序必须显式使用该参数才能隐藏黑窗，否则即使无 print 语句也会弹出终端。
打包命令漏了 -w 或 --noconsole
这是最常见原因：PyInstaller 默认把所有脚本当成控制台程序处理，会自动分配一个 console 子系统。Tkinter 本身不依赖控制台，但没加 -w 就等于告诉 Windows “请给我开个 cmd 窗口”，哪怕你代码里一句 print 都没有。
必须用这两个参数之一打包：
pyinstaller -F -w your_script.py-
pyinstaller -F --noconsole your_script.py（和-w完全等价）
注意：-F 是可选的（单文件），但 -w 对 GUI 程序是刚需。如果用了 -F 却忘了 -w，黑窗必现。
代码里调用了 os.system 或 os.popen
即使加了 -w，只要代码里有类似 os.system("ping 127.0.0.1") 或 os.popen("dir") 这种调用，Windows 会为每个子进程单独创建控制台窗口——这个黑窗和主程序无关，是子进程自己弹的。
立即学习“Python免费学习笔记（深入）”；
替换方案（仅 Windows）：
- 用
subprocess.run(cmd, creationflags=0x08000000)，0x08000000是CREATE_NO_WINDOW - 或用
subprocess.Popen(cmd, creationflags=0x08000000, stdout=subprocess.PIPE) - 避免用
os.system/os.popen，它们没法隐藏子窗口
.spec 文件里 console=True 没改
如果你先用 pyinstaller your_script.py 生成过 .spec 文件，再手动修改打包逻辑，很可能没动到关键项。打开 your_script.spec，找到这行：
console=True
改成：
console=False
然后运行 pyinstaller your_script.spec。别跳过这步——命令行加了 -w 时 PyInstaller 会自动设 console=False，但手动改 .spec 时容易忽略它。
误用了旧版 .exe 或残留缓存
打包后双击运行，结果还是黑窗？大概率你在点一个没删干净的旧文件。PyInstaller 每次打包都会在 dist/ 下生成新 .exe，但你可能还留着上次打包的副本，或者桌面快捷方式指向了老路径。
安全做法：
- 删掉整个
build/和dist/文件夹 - 加
--clean参数重打：pyinstaller --clean -F -w your_script.py - 确认双击的是
dist/your_script/your_script.exe，不是同名但路径不同的其他文件
真正麻烦的不是参数或代码，而是黑窗可能来自子进程、缓存、或 spec 文件里一个没改的 True —— 它们不会报错，只安静地弹窗。
