如何为pytest设置固定的项目根目录日志文件路径？

方法一：修改pytest.ini配置（推荐） #

直接在pytest.ini中使用pytest内置的{rootdir}变量指定日志路径，该变量会自动指向项目根目录，避免相对路径导致的多目录创建问题：

[pytest]
log_file = {rootdir}/logs/tests.log
log_level = INFO  # 可根据需求调整日志级别

配置后，pytest会统一在项目根目录下的logs文件夹生成tests.log，不会在各测试子目录重复创建日志目录。

方法二：通过conftest.py配置日志 #

如果要通过conftest实现，需将配置逻辑定义为autouse fixture，确保测试运行前自动执行，同时避免重复配置日志：

import os
import logging
import pytest

@pytest.fixture(scope="session", autouse=True)
def setup_logging(request):
    # 获取项目根目录
    root_dir = request.config.rootdir
    log_dir = os.path.join(root_dir, "logs")
    # 确保日志目录存在，不存在则创建
    os.makedirs(log_dir, exist_ok=True)
    log_file = os.path.join(log_dir, "tests.log")
    
    # 仅在首次调用时配置日志，避免重复配置导致日志重复输出
    if not logging.getLogger().handlers:
        logging.basicConfig(
            filename=log_file,
            level=logging.INFO,
            format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
        )

• scope="session"确保整个测试会话仅执行一次日志配置
• autouse=True让fixture自动生效，无需在测试函数中显式调用
• 检查handlers是否存在，避免重复调用basicConfig引发的日志重复输出问题

原配置失效原因说明 #

• 原pytest.ini中的相对路径logs/tests.log是相对于每个测试文件所在目录解析的，因此每个测试子目录都会生成独立的logs文件夹
• 原conftest中的函数未被定义为fixture，也未设置自动执行规则，导致配置代码从未运行

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