VSCode调试Python unittest与常规执行行为不一致问题求助

环境信息 #

• 操作系统：Windows 10
• Python版本：3.10/3.11/3.9（三个版本表现一致）
• 10天前功能正常运行，怀疑是软件更新引发问题

问题详情 #

• 在VSCode中使用测试运行器调试Python unittest时，仅调试模式下出现ModuleNotFoundError，打印sys.path发现调试环境缺失工作区根目录
• 额外异常：运行单个unittest用例时，调试器会自动进入其他测试文件并报错，需将无关测试文件移出目录才能正常调试

最小复现结构 #

proj/
├── lib/
│   └── main.py
└── test/
    └── test_main.py

test_main.py代码：

from lib.main import m

已尝试的无效方案 #

• 将完整VSCode配置克隆到MacOS，可正常运行（调试器sys.path包含根目录）
• 回滚VSCode至数月前版本
• 回滚Pylance和Python扩展至数月前版本
• 手动将工作区路径添加到sys.path，但导致Azure CLI出现常规执行时不会触发的错误
• 配置settings.json中的python.testing.cwd，对sys.path无影响（MacOS下该配置也无效）
• 禁用除Python和Pylance外的所有VSCode扩展

可行解决方案 #

1. 调试配置中添加PYTHONPATH环境变量 #

在.vscode/launch.json中为unittest调试任务配置PYTHONPATH，强制将工作区根目录加入模块搜索路径，且不影响常规执行环境：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Unittest",
            "type": "python",
            "request": "launch",
            "module": "unittest",
            "args": ["discover", "-s", "test"],
            "env": {
                "PYTHONPATH": "${workspaceFolder}"
            },
            "justMyCode": true
        }
    ]
}

2. 检查unittest运行器参数配置 #

打开VSCode设置（Ctrl+,），搜索python.testing.unittestArgs，确保参数指向正确的测试目录：

"python.testing.unittestArgs": [
    "-v",
    "-s",
    "./test",
    "-p",
    "*test*.py"
]

确认-s参数指定的是测试目录的相对路径，且工作区根目录被VSCode正确识别（需直接打开proj文件夹作为工作区）。

3. 配置Pylance额外路径辅助解析 #

在settings.json中添加Pylance的额外路径配置，确保编辑器和调试器都能识别lib目录：

"python.analysis.extraPaths": [
    "${workspaceFolder}/lib"
]

4. 重置Python扩展配置 #

若回滚扩展无效，可尝试重置Python扩展的相关配置：

1. 打开命令面板（Ctrl+Shift+P）
2. 输入Preferences: Open User Settings (JSON)
3. 删除所有与python.testing、python.analysis相关的配置项，之后重新配置unittest测试运行器

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