根本原因是python测试框架未被正确识别或vscode找不到测试文件；需确认已安装pytest、测试文件命名合规（如test_*.py）、settings.json中python.testing.pytestargs配置正确。
Test Explorer UI插件装了但没反应
根本原因通常是Python测试框架未被正确识别，或者VSCode没找到测试文件。Test Explorer UI本身不运行测试，它只依赖底层测试框架（如pytest、unittest）的输出格式来渲染界面。
检查以下三点：
- 确认已安装对应测试框架：
pip install pytest（推荐）或pip install unittest（无需额外安装，但需注意VSCode对它的支持较弱） - 确保工作区根目录下存在测试文件，命名匹配默认模式：
test_*.py或*_test.py - 在VSCode设置中搜索
python.testing.pytestArgs，确认值不是空或错误路径；若用pytest，建议显式设为["--collect-only"]测试发现是否正常
pytest配置文件不生效导致测试不显示
VSCode的Python测试功能会读取 pytest.ini、pyproject.toml 或 setup.cfg 中的配置，但只认特定section。常见失效是因为写错section名或路径层级不对。
最简有效配置示例（放在项目根目录）：
[tool:pytest] testpaths = tests python_files = test_*.py *_test.py python_classes = Test* python_functions = test_*
注意：
-
testpaths必须是相对当前工作区的路径，不能是绝对路径 - 如果用
pyproject.toml，section必须是[tool.pytest.ini_options]，不是[pytest] - 修改后需重启VSCode或点击Test Explorer右上角刷新按钮（⚡图标），否则缓存可能不更新
“No tests found”但命令行能跑通
这是典型路径上下文不一致问题。VSCode启动测试时，默认以打开的文件夹为工作目录（cwd），而你在终端里可能在子目录下执行的 pytest。
排查步骤：
- 打开VSCode的输出面板（
Ctrl+Shift+U），选择“Python Test Log”，看实际执行的命令和cwd路径 - 对比终端中成功运行的命令，比如你输的是
cd tests && pytest，那VSCode里就得把testpaths设为["tests"]，而不是默认的["."] - 临时加个
conftest.py在根目录，内容为print("cwd:", __file__)，运行测试看输出位置，验证VSCode到底从哪启的进程
Test Explorer UI显示“Loading…”卡住不动
大概率是测试发现阶段抛了未捕获异常，比如导入失败、路径错误、fixture定义出错，但VSCode没把错误日志暴露出来。
解决办法很直接：
- 在终端手动运行
pytest --collect-only，观察是否报错；常见如ModuleNotFoundError、ImportError或RecursionError - 检查是否有测试文件里写了执行逻辑（比如顶层调用了函数），pytest收集阶段会执行模块级代码，出错就中断发现流程
- 禁用所有其他Python相关插件（尤其是旧版Python插件或Pylance冲突），只留
Test Explorer UI和官方Python插件，排除干扰
测试发现本身不依赖调试器或解释器路径，但严重依赖模块可导入性——这点最容易被忽略。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
