如何在Python logging的fileConfig配置文件中设置可变日志目录？

我用Python logging模块，通过logging.config.fileConfig(config_file)加载logging.cfg配置文件，里面用到了TimedRotatingFileHandler，之前运行正常。原简化配置如下：

[handler_file]
class=handlers.TimedRotatingFileHandler
formatter=complex
level=DEBUG
args=('logs/logging.log', 'midnight')

现在想把配置里的日志目录（logs）改成可配置项，但还要保留用配置文件的方式。试过注入变量log_directory做字符串插值：

args=('%(log_directory)s/logging.log', 'midnight')

或者用logging的eval特性写：

args=(f'{log_directory}/logging.log', 'midnight')

但都没成功，缺了关键步骤，问在保留配置文件的前提下，最优实现方法是什么？

核心是利用logging.config.fileConfig的defaults参数传递变量，配合配置文件里的字符串插值语法，具体步骤如下：

1. 修改Python加载配置的代码 #

在调用fileConfig时，通过defaults参数传入你的日志目录变量，同时提前确保目录存在（避免日志写入失败）：

import logging.config
import os

# 定义日志目录，可按需修改，比如从环境变量读取
log_directory = "custom_logs"
# 自动创建目录，已存在则不报错
os.makedirs(log_directory, exist_ok=True)

# 加载配置文件，传入defaults参数传递变量
logging.config.fileConfig(
    "logging.cfg",
    defaults={"log_directory": log_directory}
)

# 测试日志输出
logger = logging.getLogger(__name__)
logger.debug("这是一条测试日志，会写入自定义目录")

2. 修改logging.cfg配置文件 #

在args里用%(log_directory)s引用传入的变量即可：

[handler_file]
class=handlers.TimedRotatingFileHandler
formatter=complex
level=DEBUG
args=('%(log_directory)s/logging.log', 'midnight')

为什么之前的尝试失败？ #

• 直接写%(log_directory)s但没通过defaults传变量：fileConfig不会自动识别外部变量，必须显式通过defaults注入到配置的命名空间里。
• 用f-string写法：配置文件里的args会被eval执行，但log_directory变量不在配置文件的执行环境中，会抛出NameError。

进阶优化（可选） #

如果想让日志目录更灵活，比如从环境变量读取，只需要修改Python代码里的log_directory定义：

log_directory = os.getenv("APP_LOG_DIR", "default_logs")

这样部署时可以通过环境变量指定日志目录，不用修改代码或配置文件。

内容的提问来源于stack exchange，提问作者Halvor Holsten Strand