直接配pytest运行当前测试文件需用python -m pytest "$file" -v,设working_dir为"$file_path"确保路径解析正确,selector限定.py文件,file_regex支持错误跳转;单函数运行用-k "func_name";虚拟环境需显式指定解释器路径。

直接配 pytest 运行当前测试文件
想按 Ctrl+B 就跑当前打开的 test_*.py 文件,核心是构建系统里用 $file 变量传入 pytest,而不是硬编码路径。默认的 Python 构建系统不带 pytest 支持,必须新建一个:
-
"cmd": ["python", "-m", "pytest", "$file", "-v"]—— 必须用python -m pytest,否则可能因路径问题找不到 conftest.py 或项目模块 -
"working_dir": "$file_path"—— 单文件场景下,工作目录设为文件所在目录,确保相对导入(如from ..src import foo)能正常解析(但注意:这仅适用于扁平结构;若项目有src/套路,得换方案) -
"selector": "source.python"—— 确保只在 .py 文件里激活该构建系统 -
"file_regex": "^[ ]*File "(*?)", line ([0-9]*)"—— 让错误跳转生效,点击报错行直接定位到源码
运行单个测试函数(不是整个文件)
当你只想验证 test_login 这个函数,而不是跑满屏的 test_*.py,就得靠 pytest 的 -k 参数。构建系统里把 $file 换成 $file::test_login 不可靠(Sublime 不解析双冒号),正确做法是加 -k 并引用函数名:
"cmd": ["python", "-m", "pytest", "$file", "-k", "test_login", "-v"]- 函数名必须完全匹配,区分大小写;支持模糊匹配,比如
-k "login and not smoke"也合法 - 如果函数名含空格或特殊字符,pytest 会静默忽略,不会报错——建议先在终端手动试一次
pytest test_auth.py -k "test_user_login"确认能命中 - 别写成
"-k test_login"合并成一个字符串,Sublime 构建系统要求每个参数独立成数组项,否则会被当做一个参数传给 pytest,导致解析失败
虚拟环境下的 Python 解释器路径怎么填
如果你用 venv 或 poetry,python 命令可能指向系统 Python,导致 pytest 找不到你安装的包。这时不能只改 cmd 里的第一个元素,而要显式指定解释器路径:
- Linux/macOS:把
"python"换成类似"/path/to/venv/bin/python" - Windows:换成
"C:\Users\you\venv\Scripts\python.exe"(注意双反斜杠或原始字符串写法) - 更灵活的方式是用
${project_path:./venv/bin/python}这类变量 fallback,但 Sublime 不支持嵌套变量,所以实际常用的是:先确认which python输出,再硬编码进去 - 千万别依赖
shell: true+source venv/bin/activate—— 构建系统不继承 shell 环境,source在这里根本不起作用
为什么有时 Ctrl+B 没反应或报 ImportError
常见假阳性不是配置写错了,而是执行上下文没对上:
- 文件没保存 ——
$file变量只对已保存文件有效,未保存的临时标签页会传空字符串,pytest 直接退出 - working_dir 设成了
$project_path,但当前没打开项目(即没 .sublime-project 文件),此时$project_path是空字符串,pytest 就在用户主目录或 Sublime 启动目录下跑,自然找不到你的tests/ - pytest 安装在虚拟环境,但构建系统调用的是全局
python,结果 ImportError 说找不到pytest自身 —— 先运行which pytest看它在哪,再决定是改cmd还是改解释器路径 - 文件编码不是 UTF-8,且含中文 docstring 或注释,pytest 会卡在语法解析阶段,报错信息可能被截断,看不出根源;建议统一用 UTF-8 无 BOM
$file_path,手动跑一遍 python -m pytest xxx.py,结果一致,构建系统才可能成功。











