VSCode pytest测试发现及调试遇ModuleNotFoundError，求解决方案

我之前也碰到过一模一样的情况！命令行用python -m pytest能正常跑，但VSCode的测试发现死活找不到project模块，核心原因是VSCode默认没有把你的项目根目录加入Python的搜索路径，而python -m命令会自动把当前工作目录（也就是你的项目根）加到sys.path里，所以命令行能正常运行。

下面是几个亲测有效的解决方案，按优先级来：

1. 配置VSCode的Python分析与测试设置 #

打开VSCode的设置JSON文件（快捷键Ctrl+Shift+P，输入Preferences: Open Settings (JSON)），添加以下配置：

{
    // 让VSCode的Python分析器识别project模块
    "python.analysis.extraPaths": ["${workspaceFolder}"],
    // 配置pytest以项目根为工作目录，用模块方式运行测试
    "python.testing.pytestArgs": ["project"],
    "python.testing.cwd": "${workspaceFolder}",
    // 确保选中了正确的Python解释器（比如你的虚拟环境）
    "python.defaultInterpreterPath": "${workspaceFolder}/venv/bin/python" // 按需修改路径
}

添加后保存，重启VSCode再试试测试发现，应该就能识别到project模块了。

2. 调试时的额外配置（launch.json） #

如果调试单个测试文件也报错，需要配置调试环境的PYTHONPATH：

1. 打开调试面板，点击“创建launch.json文件”，选择Python环境
2. 修改生成的launch.json，添加cwd和env字段：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Test File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "cwd": "${workspaceFolder}",
            "env": {"PYTHONPATH": "${workspaceFolder}"},
            "console": "integratedTerminal"
        }
    ]
}

这样调试时，VSCode会把项目根目录加到Python的搜索路径里，导入project.package1.module1就没问题了。

3. 临时验证方案（不推荐长期用） #

如果不想改配置，也可以在test.py开头手动添加项目根目录到sys.path：

import sys
from pathlib import Path

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

import project.package1.module1 as module1

不过这种硬编码的方式不够优雅，优先推荐前面的VSCode配置方案。

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