Python日志配置最佳实践：如何兼顾配置生效与PEP8规范？

方法1：手动配置日志Handler（完全控制） #

当其他包已初始化logging导致basicConfig失效时，直接手动创建并设置Handler和Formatter，不受默认初始化影响，同时保持导入语句在文件顶部符合PEP8。

示例代码：

import logging
import foo
from bar import baz

# 获取根Logger实例
root_logger = logging.getLogger()
root_logger.setLevel(logging.INFO)  # 设置全局日志级别

# 移除所有已存在的默认Handler（避免重复输出）
for handler in root_logger.handlers[:]:
    root_logger.removeHandler(handler)

# 创建自定义Handler和Formatter
console_handler = logging.StreamHandler()
log_formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
console_handler.setFormatter(log_formatter)

# 将Handler添加到根Logger
root_logger.addHandler(console_handler)

方法2：使用独立配置模块（规范集中管理） #

把日志配置逻辑抽离到单独的模块中，按PEP8的导入顺序分组导入，再执行配置，既符合规范又能保证配置生效。

1. 创建log_config.py配置模块：

import logging

def setup_logging():
    logging.basicConfig(
        level=logging.INFO,
        format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
        # 可添加其他配置如filename等
    )

2. 主文件中按PEP8顺序导入并配置：

# 标准库导入
import logging

# 本地模块导入
from log_config import setup_logging

# 执行日志配置
setup_logging()

# 第三方/其他包导入
import foo
from bar import baz

PEP8允许在导入分组后立即执行必要的初始化代码，这种方式既保持了导入顺序规范，又能确保日志配置在其他包导入前生效。

方法3：检查日志初始化状态再配置（轻量兼容） #

通过检查根Logger是否已有Handler，决定是否执行basicConfig，既符合PEP8导入顺序，又能兼容其他包的日志配置。

示例代码：

import logging
import foo
from bar import baz

# 仅当日志未被初始化时执行配置
if not logging.getLogger().handlers:
    logging.basicConfig(
        level=logging.INFO,
        format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
    )

如果其他包已经初始化了日志（添加了Handler），则跳过自身配置；若未初始化，则应用自定义配置，适合小型项目快速解决问题。

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