如何配置VS Code pytest适配Python代码不在顶层目录的项目结构？

你遇到的问题是因为pytest默认不会自动将每个项目的根目录加入Python的模块搜索路径，导致tests目录下的测试文件找不到同级的simple_package。以下是几种可行的配置方案：

方案1：为每个项目添加本地pytest配置文件 #

在每个项目的根目录（比如new_project/和old_project/）下创建pytest.ini文件，内容如下：

[pytest]
pythonpath = .

这个配置会告诉pytest将当前项目根目录加入Python的模块搜索路径，测试文件里import simple_package就能正常找到模块。

或者，也可以在每个项目的tests/目录下创建conftest.py文件，通过代码动态添加路径：

import sys
from pathlib import Path

# 将项目根目录加入sys.path
sys.path.append(str(Path(__file__).parent.parent))

两种方式都能让pytest识别到当前项目下的包。

方案2：运行pytest时指定Python路径 #

在终端中进入对应项目的根目录（比如cd new_project），然后执行：

pytest --pythonpath=.

如果用VS Code的Test Explorer，可以在设置中配置pytest的默认参数：

• 打开VS Code设置（Ctrl+,）
• 搜索pytest args
• 添加--pythonpath=.到参数列表中，注意要确保当前工作区是对应项目的根目录，或者针对不同项目设置工作区配置。

方案3：配置VS Code工作区的Python路径 #

如果在VS Code中同时管理两个项目，可以创建工作区文件，为每个项目单独配置额外路径：

1. 打开VS Code，将new_project和old_project都添加到工作区
2. 打开工作区设置（文件 -> 首选项 -> 设置 -> 工作区）
3. 添加以下配置到settings.json：

{
  "folders": [
    {
      "path": "new_project"
    },
    {
      "path": "old_project"
    }
  ],
  "settings": {
    "python.analysis.extraPaths": [
      "${workspaceFolder}/new_project",
      "${workspaceFolder}/old_project"
    ]
  }
}

这样VS Code的Python分析器和pytest都能找到两个项目下的包。

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