Python项目中如何实现注册插件仅对单个指定目录生效

问题根因 #

• pytest中通过conftest注册的插件默认会挂载到全局插件管理器，不会自动绑定conftest所在目录的作用域，只要conftest被pytest加载，注册的钩子逻辑对整个测试会话都生效。
• 你项目中my_dir3的逻辑会调用my_dir2的代码，pytest收集、执行用例时会追溯跨目录依赖，进一步导致插件逻辑误触发到my_dir3的用例上。

可落地配置方案 #

方案1：钩子内加路径白名单判断（推荐，稳定性最高） #

不需要调整现有目录结构，直接在插件的所有钩子函数开头增加路径校验，仅当当前执行的测试用例属于my_dir2目录范围时，才执行插件逻辑。
示例代码（写在my_dir2/conftest.py中）：

from pathlib import Path

# 提前获取my_dir2的绝对路径，避免相对路径判断出错
TARGET_DIR = Path(__file__).parent.resolve()

# 原有插件注册逻辑保留
def pytest_configure(config):
    config.pluginmanager.register(your_custom_plugin_instance, "my_dir1_custom_plugin")

# 以pytest_runtest_setup钩子为例，所有你实现的插件钩子都要加这段判断
def pytest_runtest_setup(item):
    # 获取当前执行用例的文件绝对路径
    current_test_path = Path(item.fspath).resolve()
    # 不在目标目录范围内直接跳过插件逻辑
    if not str(current_test_path).startswith(str(TARGET_DIR)):
        return
    # 下方写你原有的插件业务逻辑
    # ...

这种方式完全不受跨目录代码调用的影响，哪怕my_dir3的用例导入了my_dir2的方法，只要用例本身存放在my_dir3下，插件就不会触发。

方案2：自定义标记做隔离 #

如果不想每个钩子都写路径判断，可以通过pytest自定义标记实现自动打标+逻辑过滤：

1. 先在项目根目录的pytest.ini中注册自定义标记，避免pytest告警：

[pytest]
markers =
    enable_my_dir2_plugin: 触发my_dir1自定义插件逻辑

2. 在my_dir2/conftest.py中增加自动打标逻辑，给所有my_dir2下的用例自动加上标记，无需手动逐个添加：

from pathlib import Path
TARGET_DIR = Path(__file__).parent.resolve()

def pytest_collection_modifyitems(items):
    for item in items:
        test_path = Path(item.fspath).resolve()
        if str(test_path).startswith(str(TARGET_DIR)):
            item.add_marker("enable_my_dir2_plugin")

3. 在插件的所有钩子开头加标记判断，没有对应标记直接跳过逻辑：

def pytest_runtest_setup(item):
    if "enable_my_dir2_plugin" not in item.keywords:
        return
    # 原有插件逻辑
    # ...

注意事项 #

不要尝试通过拆分conftest位置、调整目录嵌套关系实现隔离——pytest的插件注册机制是会话级全局的，只要conftest在测试启动时被加载，上面注册的插件就会作用于全量用例，没有自动的目录隔离能力，必须手动加过滤逻辑。

内容的提问来源于stack exchange，提问作者D. Bazel