VS Code开发容器conda环境无法识别src目录, pytest测试发现失败

• 本次测试发现失败的本质是pytest运行时的Python模块搜索路径，没有包含存放ent包的src目录：
  • 你项目结构里ent包实际位于/workspaces/backend/src/ent，而非项目根目录下的直接子文件夹
  • 日常开发时的代码提示、跳转正常，是因为VS Code的智能提示模块单独配置了src路径，但pytest触发测试发现时，会独立按照自身规则加载搜索路径，没有同步读取智能提示的配置
  • 当tests/conftest.py尝试执行from ent.models.control import USER导入时，因为路径缺失就触发了ModuleNotFoundError

方法1：通过pytest原生配置指定源码路径（推荐） #

• 在项目根目录新建/修改pytest.ini文件，添加如下配置：

[pytest]
pythonpath = src

• 若项目通过pyproject.toml统一管理工具配置，可在pytest对应配置段落中添加pythonpath = ["src"]
• 配置完成后，重启VS Code的测试面板，重新触发测试发现即可。

方法2：通过VS Code Python环境配置补全搜索路径 #

• 打开工作区下的.vscode/settings.json，添加pytest与环境变量关联配置：

{
  "python.testing.pytestArgs": ["tests"],
  "python.envFile": "${workspaceFolder}/.env"
}

• 在项目根目录新建.env文件，写入路径配置：

PYTHONPATH=/workspaces/backend/src

• 保存后重启VS Code的Python测试服务，再重新尝试测试发现。

方法3：临时排查用的快速验证方案 #

• 直接在tests/conftest.py的所有导入语句最开头，添加路径插入逻辑：

import sys
from pathlib import Path
# 将src目录加入Python模块搜索路径
sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "src"))

• 该方法仅适合临时验证报错原因，不推荐长期使用，因为会将路径逻辑硬绑定在测试配置中，迁移环境时容易出现兼容问题。

• 配置路径时需要指向src目录本身，不要直接指向src/ent文件夹，否则pytest依然无法正确识别ent为可导入的顶层包
• 不需要手动在devcontainer的conda环境中修改全局环境变量，只要配置与当前选中的VS Code Python解释器对应，pytest就可以正常加载环境。

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