如何为VS Code单元测试指定可解析工作区变量的相对PYTHONPATH

方案1：直接通过Python扩展的测试专属环境变量配置 #

VS Code官方Python扩展为测试场景单独提供了环境变量配置项，原生支持${workspaceFolder}等内置变量自动展开，不需要硬编码绝对路径，配置可直接提交Git做版本管理。
操作步骤：

• 打开项目内的.vscode/settings.json文件（不存在则手动新建）
• 添加测试相关配置，示例如下：

{
    // 根据实际使用的测试框架开启对应开关
    "python.testing.pytestEnabled": true,
    "python.testing.unittestEnabled": false,
    // 测试进程环境变量注入配置，支持所有VS Code内置变量
    "python.testing.env": {
        // 用${pathSeparator}自动适配Windows/macOS/Linux的路径分隔符，实现跨平台兼容
        "PYTHONPATH": "${workspaceFolder}${pathSeparator}src:${workspaceFolder}"
    }
}

配置保存后，重启VS Code的测试发现进程，单元测试即可正常读取到正确的PYTHONPATH，和此前在launch.json中配置的常规运行场景效果完全一致。

方案2：通过测试框架配置动态注入路径（编辑器无关，兼容性最好） #

如果希望配置不绑定VS Code，不管用什么编辑器、在命令行/CI环境跑测试都能自动识别路径，可以直接通过测试框架本身的机制解决，完全绕开编辑器的环境变量配置逻辑。
如果你使用pytest（目前Python生态最常用的单元测试框架）：

• 在项目根目录新建conftest.py文件（pytest启动时会自动加载该文件）
• 在文件顶部添加代码，动态将项目路径加入Python搜索路径：

import sys
from pathlib import Path
# 将项目根目录加入搜索路径
PROJECT_ROOT = Path(__file__).parent.resolve()
sys.path.insert(0, str(PROJECT_ROOT))
# 如果源码存放在src目录下，额外添加src路径
# sys.path.insert(0, str(PROJECT_ROOT / "src"))

该方案不依赖任何编辑器的专属配置，PyCharm、VS Code、命令行执行pytest时都会自动生效，不需要重复做路径配置。
如果你使用标准库unittest，可以通过在测试目录的__init__.py中添加同样的路径注入代码实现相同效果。

根目录.env文件不支持变量展开的原因 #

VS Code Python扩展加载根目录.env文件时，使用的是纯文本键值对解析逻辑，不会走VS Code内置的变量替换管道，因此${workspaceFolder}这类变量不会被自动展开，只能填写固定的绝对路径，不适合纳入版本管理。需要动态变量的环境变量配置，测试场景统一放在python.testing.env下，常规运行/调试场景继续使用launch.json的env块即可。

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