VSCode需手动配置pytest为测试框架：设置python.testing.testFramework为pytest，安装pytest，激活正确解释器并重启VSCode；pytestArgs须为列表格式，调试时设cwd为${workspaceFolder}确保导入正常。
VSCode 能直接运行 Pytest，但默认不识别 pytest 为测试框架——必须手动指定，否则右上角“运行测试”按钮灰掉、python.testing.pytestArgs 配置无效、调试器启动失败。
怎么让 VSCode 找到并使用 pytest
VSCode 的 Python 扩展靠配置项识别测试框架，不是靠安装了 pytest 就自动生效。关键在设置里明确声明测试工具类型和入口。
- 打开设置（
Ctrl+,或Cmd+,），搜索python.testing.testFramework，选pytest - 确保已安装
pytest：在项目根目录运行pip install pytest（推荐用虚拟环境） - VSCode 必须已激活对应 Python 解释器（左下角点击 Python 版本，选对 interpreter）
- 重启 VSCode 窗口（仅重载窗口不够，得关掉再开）
为什么 pytestArgs 配置常失效
python.testing.pytestArgs 是个列表，不是字符串；路径、参数顺序、空格都敏感；且只在测试发现阶段生效，不影响手动终端运行。
- 错误写法：
"python.testing.pytestArgs": "--rootdir=src --tb=short"（字符串 → 报错） - 正确写法：
"python.testing.pytestArgs": ["--rootdir=src", "--tb=short"] - 路径用相对项目根目录写，比如测试在
tests/，就加"-s", "tests/" - 若用
conftest.py，确保它在pytestArgs指定的 rootdir 下，否则不加载
调试单个测试函数总报 ModuleNotFoundError
VSCode 调试测试时，工作目录默认是文件所在目录，不是项目根目录，导致 import 失败。
立即学习“Python免费学习笔记（深入）”；
- 在测试文件顶部加
print(Path.cwd())确认当前工作路径 - 在
.vscode/settings.json中加："python.testing.cwd": "${workspaceFolder}" - 或在
launch.json的测试配置里显式设"cwd": "${workspaceFolder}" - 避免在测试里用
sys.path.append(…)临时修复——调试器不继承终端的sys.path
测试发现失败但终端能跑，常见原因
VSCode 测试发现走的是 pytest --collect-only，它比手动运行更严格：文件名、函数名、路径结构必须符合约定。
- 文件名必须匹配
test_*.py或*_test.py（默认规则，可改但别轻易动） - 测试函数必须以
test_开头，且不能带参数（除非用@pytest.mark.parametrize） - 如果用了
__init__.py，确保每个测试目录都有，否则pytest不当包处理 - 检查有没有
pyproject.toml或setup.cfg里写了[tool:pytest]但路径配置冲突
最麻烦的是混合使用 unittest 和 pytest 的老项目：VSCode 一旦检测到 unittest 相关结构（比如 test_*.py 里有 TestCase 子类），可能 fallback 到 unittest 模式，此时 pytestArgs 完全不生效——得删掉 TestCase 类或显式禁用 unittest 发现。
