PyInstaller打包生成的exe无法识别argparse的-h/--help参数问题问询

• PyInstaller打包时默认使用了--windowed/-w参数，这个参数会把程序标记为窗口应用而非控制台应用，Windows系统会直接切断窗口应用的标准输入输出流，所以ArgumentParser输出的帮助信息没法打印到控制台。
• 就算你没手动加--windowed，如果你的脚本里用到了PyQt、Tkinter这类GUI库，PyInstaller会自动识别并启用窗口模式，关闭控制台输出。

方案1：打包时启用控制台模式（适合需要经常用命令行参数的场景） #

打包时去掉--windowed/-w参数，手动加上--console/-c参数，强制生成控制台程序，示例打包命令：

pyinstaller -c src/plot_auto.py

打包完成后运行exe加-h参数就能正常输出帮助信息，程序运行时也会保留黑框控制台窗口。

方案2：保留窗口模式，手动弹窗展示帮助信息（适合GUI程序，不想显示控制台黑框的场景） #

在解析参数前先判断是否传入了-h/--help参数，识别到后直接用GUI弹窗打印帮助内容，示例代码：

import sys
from argparse import ArgumentParser
from tkinter import messagebox # 替换为你使用的GUI库对应的弹窗组件即可

parser = ArgumentParser()
parser.add_argument("--legend", action="store_true", help="Show legend on plot.")
parser.add_argument("--figname", type=str, help="Specify the window title.")

if len(sys.argv) > 1 and sys.argv[1] in ("-h", "--help"):
    help_text = parser.format_help()
    # GUI弹窗输出帮助
    messagebox.showinfo("命令帮助", help_text)
    sys.exit(0)

# 后续正常的参数解析逻辑
args = parser.parse_args()

打包时就算用--windowed参数，传入-h也会弹出带帮助内容的提示框。

方案3：临时重定向标准输出到控制台（仅调试用） #

如果已经打包成窗口程序不想重新打包，可以运行exe前先在当前cmd窗口执行attach操作，或者用下面的代码在程序启动时主动关联父控制台：

import sys
from ctypes import windll

if len(sys.argv) > 1 and sys.argv[1] in ("-h", "--help"):
    windll.kernel32.AttachConsole(-1)
    sys.stdout = open("CONOUT$", "w")
    sys.stderr = open("CONOUT$", "w")
    parser.print_help()
    sys.stdout.close()
    sys.stderr.close()
    windll.kernel32.FreeConsole()
    sys.exit(0)

这个方案可以在保留无黑框GUI的前提下，把帮助信息直接打印到当前执行命令的cmd窗口里。

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