如何在Python项目中全局实现--verbose标志的最优方案？

我有一个包含多个函数的Python项目，已经在单个函数内实现了verbose打印功能（代码示例如下）。现在想在多个函数中复用该功能，不想每个函数都重复定义。尝试在config.py中定义全局verboseprint函数但未生效，因为该函数依赖config.py本地的verbose变量。我已经实现了传参调用的方式，但不想每次调用都传递verbose标志，请问如何正确实现可导入的全局verbose打印功能？

单个函数实现示例 #

def func(a, b=None, verbose=False):
    verboseprint = print if verbose else lambda *a, **k: None
    
    verboseprint('only if verbose')
    print('always printed')

# 调用示例
>>> func(2)
always printed
>>> func(2, verbose=True)
only if verbose
always printed

失败的全局实现示例 #

config.py

verbose = False
def verboseprint(text):
    print(text) if verbose else lambda *a, **k: None

main.py

from config import verboseprint

def func(a, b=None, verbose=False):
    verboseprint('only if verbose')
    print('always printed')

# 调用示例
>>> from main import func
>>> func(a)
always printed
>>> func(a, verbose=True)
always printed

可运行但不想用的传参方式 #

config.py

def verboseprint(text, verbose=False):
    print(text) if verbose else lambda *a, **k: None

main.py

from config import verboseprint

def func(a, b=None, verbose=False):
    verboseprint('only if verbose', verbose)
    print('always printed')

# 调用示例
>>> from main import func
>>> func(a)
always printed
>>> func(a, verbose=True)
only if verbose
always printed

给你几种实用的实现方式，既能复用verbose打印逻辑，又不用每次调用都传参：

方法1：模块级变量动态控制 #

直接用模块变量管理全局verbose状态，同时提供修改入口，函数也能临时覆盖全局设置：

config.py

verbose = False

def set_verbose(value):
    global verbose
    verbose = value

def verboseprint(*args, **kwargs):
    if verbose:
        print(*args, **kwargs)

main.py

from config import verboseprint, set_verbose

def func(a, b=None, verbose=None):
    # 保存全局原状态，避免影响其他函数
    import config
    original_verbose = config.verbose
    try:
        # 如果函数传入verbose，临时覆盖全局设置
        if verbose is not None:
            config.verbose = verbose
        verboseprint('only if verbose')
        print('always printed')
    finally:
        # 恢复全局状态
        config.verbose = original_verbose

# 调用示例
>>> func(2)
always printed
>>> func(2, verbose=True)
only if verbose
always printed
# 全局设置生效
>>> set_verbose(True)
>>> func(2)
only if verbose
always printed

方法2：类封装verbose状态 #

用类来管理状态，既可以全局共享一个实例，也能创建多个实例分开控制不同模块的输出：

config.py

class VerbosePrinter:
    def __init__(self, verbose=False):
        self.verbose = verbose
    
    def __call__(self, *args, **kwargs):
        if self.verbose:
            print(*args, **kwargs)
    
    def set_verbose(self, value):
        self.verbose = value

# 创建全局可用的实例
verboseprint = VerbosePrinter()

main.py

from config import verboseprint

def func(a, b=None, verbose=None):
    # 临时保存原状态
    original_verbose = verboseprint.verbose
    try:
        if verbose is not None:
            verboseprint.set_verbose(verbose)
        verboseprint('only if verbose')
        print('always printed')
    finally:
        verboseprint.set_verbose(original_verbose)

# 调用示例
>>> func(2)
always printed
>>> func(2, verbose=True)
only if verbose
always printed
# 全局设置
>>> verboseprint.set_verbose(True)
>>> func(2)
only if verbose
always printed

方法3：装饰器批量注入逻辑 #

用装饰器给需要verbose功能的函数自动注入verboseprint，避免每个函数重复定义：

config.py

def verbose_decorator(func):
    def wrapper(*args, **kwargs):
        # 提取函数的verbose参数，默认False
        verbose = kwargs.pop('verbose', False)
        # 创建当前函数专属的verboseprint
        verboseprint = print if verbose else lambda *a, **k: None
        # 把verboseprint传给原函数
        return func(*args, verboseprint=verboseprint, **kwargs)
    return wrapper

main.py

from config import verbose_decorator

@verbose_decorator
def func(a, b=None, verboseprint=None):
    verboseprint('only if verbose')
    print('always printed')

# 调用示例
>>> func(2)
always printed
>>> func(2, verbose=True)
only if verbose
always printed

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