PyInstaller打包exe后出现AttributeError: 'NoneType'无flush属性问题求助

我编写了一个Python方法，用于同时向屏幕和文件打印数据，代码如下：

def printf(handler, string):
    print(string)
    sys.stdout.flush()
    if handler is not None:
        handler.write(str(string))
        handler.write("\n")

该代码在虚拟环境中运行正常，但使用PyInstaller打包成exe后，出现如下错误：

AttributeError: 'NoneType' object has no attribute 'flush'

调用flush方法导致程序崩溃，网上未找到解决方案，请问内置的sys.stdout为何会是None？

问题原因 #

PyInstaller打包exe时，会根据打包模式对标准输入输出流做特殊处理：

• 如果使用--windowed（或--noconsole）参数打包无窗口程序，PyInstaller会直接将sys.stdout和sys.stderr设置为None——这类程序没有关联的控制台窗口，无法输出内容到屏幕。
• 即使使用控制台模式打包，在程序启动的早期阶段，sys.stdout可能还未完成初始化，导致暂时为None。

解决方法 #

• 强制启用控制台打包：如果程序需要控制台输出，打包时添加--console参数（默认模式，若之前用了--windowed需显式指定），确保sys.stdout绑定到控制台流：

  pyinstaller --console your_script.py
  

• 添加None判断避免崩溃：修改代码，在调用flush()前先检查sys.stdout是否有效：

  import sys
  
  def printf(handler, string):
      print(string)
      if sys.stdout is not None:
          sys.stdout.flush()
      if handler is not None:
          handler.write(str(string))
          handler.write("\n")
          handler.flush()  # 建议文件句柄也添加flush，避免数据缓存不写入
  

• 重定向标准流（无窗口程序）：如果必须使用无窗口模式，可在程序启动时手动初始化sys.stdout，比如重定向到日志文件：

  import sys
  
  # 程序启动初期执行
  if sys.stdout is None:
      sys.stdout = open("app_log.txt", "a", encoding="utf-8")
      sys.stderr = sys.stdout  # 同时重定向错误输出
  

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