VS Code中直接执行pytest报错，需用python -m pytest才能运行的原因

直接执行pytest和用python -m pytest的核心差异在于Python解释器加载时的sys.path路径集合不同，这是导致模块找不到的根本原因：

1. 两种调用方式的路径差异 #

• 用python -m pytest时，Python会自动把**当前工作目录（你的项目根目录）**加入sys.path的最前面，所以测试代码里导入Library这类自定义模块时，解释器能在项目根找到对应的文件夹。
• 直接运行pytest时，你调用的是pytest的独立可执行文件（比如虚拟环境bin目录下的pytest脚本），这个脚本启动时的sys.path是基于pytest安装路径的，不会自动把你的项目根目录加进去。如果你的Library模块不在系统Python的site-packages里，自然会找不到。

2. 为什么pip和locust直接调用正常？ #

pip和locust的可执行脚本在安装时已经做了路径处理：要么它们本身是全局/虚拟环境的标准工具，要么你的项目模块已经通过pip install -e（可编辑安装）被注册到了site-packages，所以不管从哪里调用都能找到对应模块。但你的Library是本地未安装的自定义文件夹，不在标准路径里，所以pytest直接调用时就会报错。

3. 之前的解决方法无效的原因 #

• 添加/移除__init__.py：Python 3.3+支持命名空间包，不需要__init__.py也能识别模块文件夹，但这解决不了sys.path未包含项目根的问题，所以没用。
• vscode.env设置PYTHONPATH：这个文件的环境变量只在VS Code的内置终端或调试会话中生效，如果是在系统终端或外部终端直接运行pytest，这个变量不会被加载；另外如果设置的是<test_files_path>而不是项目根目录，也无法让解释器找到上层的Library文件夹。

快速验证与修复思路 #

• 先验证路径差异：在测试文件开头加一行import sys; print(sys.path)，分别用两种方式运行，对比输出就能看到项目根是否在sys.path里。
• 临时修复：在终端里手动设置环境变量，比如export PYTHONPATH=/你的项目根目录绝对路径，再运行pytest试试。
• 永久修复：在项目根目录创建pytest.ini文件，写入以下内容：

  [pytest]
  pythonpath = .
  

  这样pytest启动时会自动把当前目录（项目根）加入sys.path，不管怎么调用都能找到自定义模块。

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