Git for Windows环境下Python运行时print、DEBUG日志输出异常问题

print内容延迟输出、程序终止时才统一打印的问题，确实和multiprocessing的使用直接相关，核心诱因是标准输出流的缓冲机制差异。

原因说明 #

• 不同运行环境的缓冲规则不同：Python检测到stdout为交互式终端（如Windows命令提示符、macOS终端）时，默认使用行缓冲策略，print输出自带的换行符会立刻触发缓冲区刷新，内容实时展示；如果stdout为非交互式环境（如IDE输出面板、输出重定向到文件、管道传递场景），Python会默认启用全缓冲，只有缓冲区存满、或程序退出时才会统一刷新输出内容。
• multiprocessing放大了缓冲问题：Windows系统下multiprocessing默认使用spawn方式创建子进程，子进程会独立继承父进程的输出缓冲配置，且子进程的输出缓冲区完全独立于主进程，没有主动触发刷新的前提下，子进程产生的所有print内容都会暂存在缓冲区中，直到子进程退出才批量输出。代码中的logging模块默认会主动刷新输出缓冲，因此日志内容可以实时打印，和延迟的print内容形成明显区别。

可行解决方案 #

• 单条print强制刷新：调用print时添加flush=True参数，示例：print("before api init", flush=True)
• 全局禁用输出缓冲：运行脚本时为Python解释器添加-u参数，示例：python -u 脚本名称.py，该参数会强制stdout/stderr全程无缓冲，所有内容实时输出
• 全局配置行缓冲：Python3.7及以上版本可以在代码入口处添加如下配置，全局开启行缓冲：

import sys
sys.stdout.reconfigure(line_buffering=True)

• 子进程输出适配：如果子进程内也有print输出，需要在子进程的执行逻辑开头也添加上述缓冲配置，或统一使用带flush参数的print。

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