如何为VSCode集成测试发现功能配置PYTHONPATH

先检查VSCode Python扩展的.env加载配置 #

• 得确认VSCode的Python扩展开了python.envFile设置，默认应该指向项目根目录的.env，但手动核对更稳妥：
  打开设置（快捷键Ctrl+,），搜python.envFile，确认值是${workspaceFolder}/.env
• 如果是多工作区项目，一定要把这个设置放在工作区设置里，别用全局用户设置，不然可能被覆盖

验证.env文件的格式是否正确 #

• .env里的PYTHONPATH格式不能错，比如项目根目录是/home/user/myproject，要加的模块目录是src，就这么写：

  PYTHONPATH=/home/user/myproject/src
  

  用相对路径也行（以VSCode工作区根目录为基准）：

  PYTHONPATH=./src
  

• 路径里有空格才需要加引号，比如：

  PYTHONPATH="/home/user/my project/src"
  

修改后重启Python语言服务 #

• 改完.env，VSCode不会自动加载，得手动重启语言服务：
  打开命令面板（快捷键Ctrl+Shift+P），输入Python: Restart Language Server执行
• 之后重新触发测试发现：命令面板搜Python: Discover Tests

检查测试文件的导入写法 #

• 测试文件里的模块导入要对应PYTHONPATH，比如src/my_module，测试里得写from my_module import ...，别用相对导入（比如from ..my_module import ...），不然路径容易乱

要是.env还是不生效，用pytest.ini兜底 #

• 你已经试过这个方案，但再确认下格式：
  项目根目录建pytest.ini，内容如下：

  [pytest]
  pythonpath = ./src
  

  这种方式pytest和VSCode测试集成都会直接读取，稳定性比.env更高

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