测试资源管理器看不到pytest测试，主因是路径配置错误、文件命名不匹配test_*/_test.py规则、未启用pytest框架或工作区settings.json未正确设置；运行报ModuleNotFoundError则多因cwd与模块搜索路径不一致。
VSCode 能可视化管理 pytest 测试，但前提是它真能“找到”你的测试文件、正确导入模块、并用对解释器——三者缺一不可。否则测试资源管理器里空空如也，或点击 Run Test 直接报 ModuleNotFoundError。
为什么测试资源管理器里看不到任何测试？
VSCode 不会自动扫描整个项目，它只按你配置的路径和命名规则找文件。常见原因包括：
- 测试文件不在默认扫描路径（如
tests/或根目录），且python.testing.pytestArgs没指定正确起始位置 - 文件名不匹配默认模式：
test_*.py或*_test.py；比如叫my_tests.py就会被忽略 - 没启用 pytest 框架，而是留着
python.testing.unittestEnabled: true，导致 VSCode 去找unittest.TestCase子类 - 工作区未保存
.vscode/settings.json，或配置写在用户级 settings 里，对当前项目无效
最简验证方式：终端进项目根目录，执行 pytest tests/ -v 能跑通，但 VSCode 看不见，那一定是配置路径没对上。把 "python.testing.pytestArgs": ["tests/", "-v"] 写进工作区 settings.json 即可。
测试能发现但运行就报 ModuleNotFoundError？
这几乎全是工作目录（cwd）和 Python 模块搜索路径（sys.path）不一致导致的。VSCode 默认以打开的文件夹为 cwd，但你的包结构可能是 src/mypackage/，测试里写 from mypackage import foo 就会失败。
立即学习“Python免费学习笔记（深入）”；
- 优先在
.vscode/settings.json中加"python.testing.cwd": "${workspaceFolder}/src" - 确保
python.defaultInterpreterPath指向你激活的虚拟环境解释器（如./venv/bin/python） - 不要依赖
pip install -e .后临时改sys.path——VSCode 调试器不走脚本入口，那段代码根本不会执行 - 如果包结构复杂（比如多层嵌套或
src下还有子src），直接在测试文件顶部加sys.path.insert(0, ...)是调试时最快解法，但仅限本地，别提交
Debug Test 断点不生效或跳过？
断点失效通常不是 VSCode 的 bug，而是调试启动时没加载到目标模块。核心判断点：你在测试函数里设断点，但调试器启动后直接退出，或停在 import 行报错。
- 确认你点击的是测试函数旁的
Debug Test，而不是右键编辑器选 “Debug Python File”——后者是当脚本运行，不走 pytest 入口 - 检查
python.testing.pytestArgs是否含-s（否则print()不输出，误判为没执行） - 在
launch.json里手动配一个 pytest 调试配置反而更可控，例如：
{
"version": "0.2.0",
"configurations": [
{
"name": "pytest current file",
"type": "python",
"request": "launch",
"module": "pytest",
"args": ["${file}", "-s", "-v"],
"console": "integratedTerminal",
"cwd": "${workspaceFolder}/src"
}
]
}
这样你能完全控制参数、工作目录和入口模块，比靠 UI 配置更稳定。
Pytest 参数怎么传给 VSCode？
python.testing.pytestArgs 必须是 JSON 数组，每个参数单独一项，不能合并成字符串。常见错误写法："--rootdir=."（错），正确是 "--rootdir", "."。
-
-s：必须加，否则测试中print()全被 pytest 捕获，调试时看不到中间值 -
-v：推荐加，显示完整测试函数名，方便定位 -
--tb=short：缩短 traceback，避免堆栈刷屏 - 若用
pytest.ini，VSCode 会读取它，但settings.json中的pytestArgs会覆盖 ini 里的同名项 - 禁用 unittest：显式设
"python.testing.unittestEnabled": false，避免两个框架争抢测试发现逻辑
真实项目里，测试路径、包结构、虚拟环境三者耦合紧密，VSCode 的“自动发现”只是个快捷入口，一旦出问题，就得回到命令行验证基础链路是否通——pytest tests/ -v 跑得通，再调 VSCode 配置，顺序不能反。
