首先创建自定义构建系统，配置JSON指定pytest命令，保存为Python_Pytest.sublime-build；接着修改cmd字段加入-k参数以运行单个测试函数；然后设置快捷键Ctrl+Shift+T绑定构建命令；再根据虚拟环境修改python解释器路径；最后通过输出面板查看结果，检查错误并定位问题。

如果您尝试在Sublime中运行单个Python单元测试，但无法正确调用pytest命令，则可能是由于构建系统未正确配置。以下是解决此问题的步骤：

一、创建自定义构建系统

Sublime Text通过构建系统（Build System）支持外部命令执行，可以通过配置文件指定使用pytest运行特定测试文件或测试方法。

1、打开Sublime Text，点击菜单栏的Tools → Build System → New Build System…。

2、将默认内容替换为以下JSON配置：

立即学习“Python免费学习笔记（深入）”；

{
"cmd": [“python“, “-m”, “pytest”, “$file”, “-v”],
“file_regex”: “^[ ]*File “(…*?)”, line ([0-9]*)”,
“selector”: “source.python”,
“shell”: true,
“working_dir”: “$file_path”
}

3、保存文件为

Python_Pytest.sublime-build

，建议保存在默认的Packages/User/目录下。

二、修改构建系统以运行单个测试函数

若需运行某个具体的测试函数而非整个文件，可通过pytest的语法指定函数名。

1、编辑之前创建的

Python_Pytest.sublime-build

文件。

2、修改

"cmd"

字段，加入双引号并使用

-k

参数匹配测试函数名：

"cmd": [“python”, “-m”, “pytest”, “$file”, “-k”, “$file_base_name”, “-v”]

3、更精确地控制执行范围，可手动在命令中添加函数名占位符，例如：

"cmd": [“python”, “-m”, “pytest”, “$file::$function_name”, “-v”]

4、由于Sublime不直接支持变量输入，可配合插件如

InputHelper

或使用外部脚本传递函数名。

三、设置快捷键绑定运行当前测试

通过自定义快捷键快速触发构建命令，提升开发效率。

1、进入Preferences → Key Bindings。

有道翻译AI助手

有道翻译提供即时免费的中文、英语、日语、韩语、法语、德语、俄语、西班牙语、葡萄牙语、越南语、印尼语、意大利语、荷兰语、泰语全文翻译、网页翻译、文档翻译、PDF翻

70

查看详情

2、在右侧用户键绑定中添加如下内容：

{
“keys”: [“ctrl+shift+t”],
“command”: “build”,
“args”: {“build_system”: “Packages/User/Python_Pytest.sublime-build”}
}

3、保存后，按下

Ctrl+Shift+T

即可运行当前文件中的测试。

四、使用环境变量和虚拟环境支持

当项目依赖虚拟环境时，需确保构建系统调用正确的Python解释器。

1、确认虚拟环境的Python路径，例如：

/path/to/venv/bin/python

（Linux/macOS）或

C:venvScriptspython.exe

（Windows）。

2、修改构建系统的

"cmd"

字段，替换python路径：

"cmd": [“/path/to/venv/bin/python”, “-m”, “pytest”, “$file”, “-v”]

3、在Windows系统中，若使用Anaconda或venv，应使用完整路径指向激活后的python.exe。

五、验证输出结果与错误定位

构建执行后，Sublime会在底部面板显示运行结果，便于快速排查问题。

1、运行测试后观察

Output Panel

中的输出信息。

2、如果出现

ModuleNotFoundError

，检查

working_dir

是否设置为

$file_path

。

3、启用详细模式（-v）可查看每个测试函数的执行状态。

4、利用

--tb=short

或

--tb=line

参数简化 traceback 输出，便于快速定位失败点。