VSCode测试不自动触发是因为未启用自动化发现机制，必须手动执行“Discover Tests”或点击侧边栏刷新按钮；“Run Test”按钮置灰主因是未识别到测试用例，常见于pytestEnabled设为false、未以文件夹形式打开项目、pytestArgs路径错误、文件命名不符合test_.py或_test.py规则。
VSCode 里测试任务不自动触发，不是“没配好”，而是根本没启用自动化发现机制——必须手动触发一次“Discover Tests”或改配置后点侧边栏刷新按钮，它才开始干活。
为什么“Run Test”按钮一直灰着？
这不是插件没装，也不是 pytest 没装，而是 VSCode 压根没识别到任何测试用例。常见原因包括：
-
python.testing.pytestEnabled在settings.json里设成了false或根本没写 - 项目没以文件夹形式打开（比如只打开了单个
.py文件），VSCode 测试功能完全不激活 -
python.testing.pytestArgs写了错误路径，例如["src/tests"]但实际目录是tests/，或者漏写了--rootdir导致conftest.py不加载 - 测试文件名不符合
test_*.py或*_test.py规则（mytest.py、test_main.py可以，main_tester.py就不行）
如何让测试自动出现在侧边栏？
VSCode 不会后台静默扫描，它依赖你显式配置 + 手动触发。关键动作只有两个：
- 在命令面板（
Ctrl+Shift+P）运行Python: Configure Tests→ 选pytest→ 指定目录（如tests），这会自动生成基础settings.json条目 - 改完配置后，**必须点击测试侧边栏右上角的 ↻ 刷新按钮**，否则旧缓存还在，新路径不会生效
- 如果用了
src/目录结构（源码和测试并列于src/下），python.testing.pytestArgs推荐写成["src/"]，而不是["src/tests"]—— 否则src/mymodule/下的模块导入会失败
调试时断点不命中？先看工作目录
VSCode 调试器默认把测试文件所在目录当工作目录（cwd），不是项目根目录。所以 from mypackage import x 很可能报 ModuleNotFoundError。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
立即学习“Python免费学习笔记（深入）”；
- 在
.vscode/settings.json中加："python.testing.cwd": "${workspaceFolder}"（源码在根目录）或"python.testing.cwd": "${workspaceFolder}/src"（源码在src/） - 再配一个
"python.envFile": "${workspaceFolder}/.env"，并在.env里写PYTHONPATH=${workspaceFolder}/src，双重保险 - 断点别打在
def test_xxx():那行，要打在函数体第一句可执行代码上（比如assert前），否则 pytest 加载阶段就跳过了
launch.json 调试单个测试总失败？删掉 program 字段
想用 F5 直接调试一个测试函数，launch.json 必须走模块启动模式，不能当普通脚本跑。
- 删掉
"program"字段——它和"module"冲突，VSCode 会直接忽略"module" - 必须保留
"module": "pytest"，等价于终端执行python -m pytest -
"args"是数组，例如：["tests/test_api.py::test_login", "-s"]—— 注意双冒号分隔文件和函数名 - 如果
pytestArgs里用了--rootdir=src，那么args里的路径就得相对src/写，比如["tests/test_api.py::test_login"]，不能写成["src/tests/test_api.py::test_login"]
真正卡住人的地方，从来不是哪个字段填错了，而是 cwd 和 sys.path 的隐式耦合：VSCode 调试器不继承终端环境，也不执行 pip install -e .，所有路径都得靠配置项或 .env 显式声明。
