跨平台实现文件描述符级别的标准输出重定向，以抑制模块导入时的冗余输出

我太懂这种糟心的情况了——导入个模块就弹出一堆无关的启动日志，好好的CLI工具输出全被搞得乱糟糟的！之前试了Python层面的sys.stdout重定向，结果发现模块里可能藏着C代码直接写stdout（比如用printf），甚至在Windows下用系统API写输出，这些全绕开了Python的封装，根本拦不住。下面给你一个跨平台的解决方案，不管是Linux/macOS这类POSIX系统，还是Windows都能完美搞定：

完整的跨平台上下文管理器代码 #

import contextlib
import os
import sys

@contextlib.contextmanager
def suppress_module_stdout():
    if os.name == 'posix':
        # POSIX系统（Linux/macOS）处理逻辑
        stdout_fd = sys.stdout.fileno()
        # 保存原始stdout的文件描述符副本，用于后续恢复
        original_stdout_fd = os.dup(stdout_fd)
        try:
            # 打开/dev/null设备，作为输出黑洞
            with open(os.devnull, 'w') as devnull:
                # 将当前stdout的文件描述符重定向到/dev/null
                os.dup2(devnull.fileno(), stdout_fd)
                yield
        finally:
            # 恢复原始的stdout文件描述符
            os.dup2(original_stdout_fd, stdout_fd)
            os.close(original_stdout_fd)
    elif os.name == 'nt':
        # Windows系统处理逻辑
        import ctypes
        from ctypes import wintypes

        kernel32 = ctypes.WinDLL('kernel32', use_last_error=True)
        STD_OUTPUT_HANDLE = wintypes.DWORD(-11)

        # 获取当前的标准输出句柄
        original_stdout_handle = kernel32.GetStdHandle(STD_OUTPUT_HANDLE)
        # 创建指向NUL设备的句柄（Windows版的/dev/null）
        null_handle = kernel32.CreateFileW(
            'NUL',
            wintypes.DWORD(0x40000000),  # GENERIC_WRITE 权限
            wintypes.DWORD(0x00000001),  # FILE_SHARE_WRITE 共享模式
            None,
            wintypes.DWORD(0x00000003),  # OPEN_EXISTING 打开方式
            wintypes.DWORD(0x00000080),  # FILE_ATTRIBUTE_NORMAL 属性
            None
        )
        if null_handle == wintypes.HANDLE(-1).value:
            raise ctypes.WinError(ctypes.get_last_error())
        
        try:
            # 将系统标准输出替换为NUL句柄
            if not kernel32.SetStdHandle(STD_OUTPUT_HANDLE, null_handle):
                raise ctypes.WinError(ctypes.get_last_error())
            # 刷新并重新绑定Python的sys.stdout，避免缓存旧句柄导致异常
            sys.stdout.flush()
            sys.stdout = open(sys.stdout.fileno(), 'w')
            yield
        finally:
            # 恢复原始的标准输出句柄
            if not kernel32.SetStdHandle(STD_OUTPUT_HANDLE, original_stdout_handle):
                raise ctypes.WinError(ctypes.get_last_error())
            # 恢复Python的sys.stdout对象
            sys.stdout.flush()
            sys.stdout = open(sys.stdout.fileno(), 'w')
            # 关闭NUL句柄释放资源
            kernel32.CloseHandle(null_handle)
    else:
        # 其他未测试的系统，直接放行输出
        yield

怎么用？ #

只需要在导入那个“话痨”模块前，用这个上下文管理器包裹住导入操作就行：

# 先启用输出抑制
with suppress_module_stdout():
    import problematic_module

# 现在可以正常输出你想要的内容了
print("我的CLI工具的干净输出！")

关键细节说明 #

• POSIX系统：通过直接操作文件描述符，把stdout（fd=1）重定向到/dev/null，能拦截所有直接操作文件描述符的输出，包括C代码的printf、write(1, ...)这类完全绕开Python的操作。
• Windows系统：用Windows原生API操作标准输出句柄，替换成NUL设备的句柄，同时刷新并重新绑定Python的sys.stdout——因为Python会缓存句柄，如果不重新绑定，后续可能会出现“无效句柄”的错误。
• 全局生效性：这个方法是进程级别的，在上下文管理器生效期间，所有线程的stdout输出都会被抑制，如果你的程序是多线程架构，需要注意这一点。

内容来源于stack exchange