IPython与Pytest测试导入冲突的最优解决方法咨询

这个冲突的本质是debug模式运行时，ipython的相关路径在sys.path中的优先级高于你的项目根目录，导入tests包时会优先匹配到ipython的tests目录，而非你项目下的tests目录。以下是优于你现有方案的解决办法：

• 方案1：使用pytest原生的conftest.py共享公共内容
  把utils.py中需要跨测试文件调用的变量、函数直接迁移到tests/conftest.py文件中，pytest会自动加载conftest.py内的所有对象，所有测试文件无需主动导入即可直接使用，完全规避了主动导入tests包的步骤，既符合pytest的约定规范，也不会触发命名冲突，改造成本极低。
• 方案2：配置pytest的pythonpath优先级
  在项目根目录的pytest配置文件（pyproject.toml/pytest.ini/setup.cfg任选其一）中添加配置，将项目根目录强制加到sys.path的最前方，保证导入时优先匹配项目内的tests包。以pyproject.toml为例，添加如下配置即可：

  [tool.pytest.ini_options]
  pythonpath = ["."]
  

  这个方案无需修改现有导入代码，也不需要调整目录结构，debug模式下也会生效。
• 方案3：改用相对导入
  把测试文件中from tests.utils import pan的绝对导入写法，改为同层级相对导入from .utils import pan，导入时会直接匹配当前测试文件所在目录下的utils.py，不会走全局包查找逻辑，完全规避了命名冲突的问题，适合测试目录层级不复杂的场景。

内容的提问来源于stack exchange，提问作者T. Thai