如何在代码中传递全局调试标志？是否应使用argparse？

嗨，我懂你不想给test_utils.py里每个函数都加debug_flag参数的痛苦——重复传参不仅麻烦，还容易漏改，代码看起来也冗余。这里有两种靠谱的方案，帮你优雅解决这个问题：

方案1：使用Python标准库logging（强烈推荐） #

这是Python处理日志/调试信息的标准做法，天生支持全局控制日志级别，完美匹配你的需求，扩展性还极强。

实现步骤： #

1. 在主程序test.py中，通过argparse获取debug_flag后，直接配置logging的全局级别：

# test.py
import argparse
import logging
import test_utils

def main():
    parser = argparse.ArgumentParser()
    parser.add_argument("--debug", action="store_true", help="开启调试模式")
    args = parser.parse_args()

    # 配置日志：如果开启debug，输出所有DEBUG及以上级别的日志；否则只输出INFO及以上
    logging.basicConfig(
        level=logging.DEBUG if args.debug else logging.INFO,
        format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
    )

    # 主程序里的调试语句
    logging.debug("主程序正在执行初始化操作")
    # 调用工具函数
    test_utils.process_data()

if __name__ == "__main__":
    main()

2. 在test_utils.py里，直接用logging输出调试信息，完全不需要传参：

# test_utils.py
import logging

# 获取当前模块的logger（推荐这样做，能区分日志来自哪个模块）
logger = logging.getLogger(__name__)

def process_data():
    # 只有当主程序开启debug时，这条日志才会被输出
    logger.debug("开始处理数据，当前输入参数：xxx")
    # 核心业务逻辑
    print("数据处理完成")

def validate_input(input_data):
    logger.debug("正在验证输入数据：%s", input_data)
    # 验证逻辑...
    return True

为什么推荐这个方案？ #

• 完全不用手动传递debug_flag，全局配置一次就行
• 可以灵活控制日志格式、输出位置（控制台/文件），甚至可以给不同模块设置不同的日志级别
• 支持日志分级（DEBUG/INFO/WARNING/ERROR），比自己写if debug_flag要专业得多

方案2：使用模块级全局变量（适合小型项目） #

如果你的项目很小，不想引入logging的复杂度，也可以给test_utils.py设置一个模块级的debug标志，主程序初始化时赋值即可。

实现步骤： #

1. 在test_utils.py里定义一个全局变量：

# test_utils.py
# 默认关闭调试模式
DEBUG_MODE = False

def process_data():
    if DEBUG_MODE:
        print("[DEBUG] 工具函数：开始处理数据")
    print("数据处理完成")

def validate_input(input_data):
    if DEBUG_MODE:
        print(f"[DEBUG] 工具函数：验证输入数据 {input_data}")
    # 验证逻辑...
    return True

2. 在主程序test.py中设置这个变量：

# test.py
import argparse
import test_utils

def main():
    parser = argparse.ArgumentParser()
    parser.add_argument("--debug", action="store_true", help="开启调试模式")
    args = parser.parse_args()

    # 直接设置工具模块的全局debug标志
    test_utils.DEBUG_MODE = args.debug

    # 主程序的调试语句
    if args.debug:
        print("[DEBUG] 主程序：初始化完成")
    test_utils.process_data()

if __name__ == "__main__":
    main()

注意事项： #

• 这种方法简单直接，但模块级变量是全局的，如果是多线程/多进程场景，可能会出现线程安全问题
• 没法像logging那样灵活控制日志的格式和输出位置，适合小型脚本或简单项目

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