PyCharm快速入门:怎么配置pytest单元测试环境

冬伟姑娘_3149

冬伟姑娘_3149

2026-08-17

825人浏览

原创

pycharm 默认用 unittest 运行测试,需手动配置 pytest:确认 interpreter 中已安装 pytest(建议 8.2+),在 settings → tools → python integrated tools → testing 中将 default test runner 设为 pytest,确保测试文件名(test_.py 或 _test.py)、函数名(test_)和类名(test)符合命名约定,且点击 apply 保存配置。

pycharm快速入门:怎么配置pytest单元测试环境

PyCharm 默认用 unittest 运行测试,哪怕你装了 pytest,右键“Run”也大概率会报 ImportError: No module named 'pytest' 或直接找不到测试函数——这不是你代码写错了,是 PyCharm 根本没认出你在用 pytest。

怎么确认 pytest 已安装且被 PyCharm 识别

别只在终端里跑 pip install pytest 就完事。PyCharm 可能压根没用那个环境:

  • 打开 File → Settings → Project → Python Interpreter(macOS 是 PyCharm → Preferences),看已安装包列表里有没有 pytest
  • 如果没有,点右上角 +,搜 pytest 并安装;如果已有但版本旧(比如 pytest 6.x),建议升级到 pytest 8.2+(兼容 Python 3.12+,避免 DeprecationWarning)
  • 装完别关窗口,留意右下角是否弹出“pytest detected, set as default test runner?”提示——点 Yes,它会自动帮你切配置;不弹就手动下一步

必须改的设置:Default test runner

这个选项藏得深,但改错或漏改,所有后续操作都白搭:

PyCharm 2026.2
PyCharm 2026.2

PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。

下载
  • 路径:Settings → Tools → Python Integrated Tools → Testing → Default test runner
  • 下拉框里选 pytest,不是 Unittests,也不是空着
  • 下方 Test path 留空即可(PyCharm 会自动扫描 test_*.py 和 *_test.py);如果项目结构特殊(比如测试文件全在 tests/ 目录),才填相对路径如 tests
  • 改完点 Apply,**不要只点 OK** —— Apply 才真正写入配置,OK 只关闭窗口

右键运行失败?检查文件和函数命名规则

PyCharm 的 pytest 探测器很“死板”,不符合约定就直接跳过:

  • 测试文件名必须匹配 test_*.py 或 *_test.py(例如 test_math.py ✅,math_test.py ✅,math_tests.py ❌)
  • 测试函数名必须以 test_ 开头(例如 def test_add(): ✅,def check_add(): ❌)
  • 如果用了类,类名必须以 Test 开头(例如 class TestCalculator: ✅,class CalculatorTest: ❌)
  • 函数里不能有参数(除非你配了 fixture),否则 PyCharm 会静默忽略该函数

运行时加参数(比如 -x 或 --tb=short)

想让失败时立刻停、或者看精简错误堆栈?不能只靠右键,得进运行配置:

  • 右键测试文件 → Run 'pytest in xxx.py' 后,点顶部菜单 Run → Edit Configurations
  • 左侧选中刚创建的配置(名字类似 pytest in test_math.py),右侧找到 Add parameters 输入框
  • 填 -x --tb=short(中间空格分隔),保存后下次右键运行就生效
  • 注意:全局默认参数要设在 Settings → Tools → Python Integrated Tools → Testing → Additional arguments,但建议只放项目级必需参数,避免污染其他项目

最常被忽略的一点:PyCharm 的测试探测是基于当前 interpreter 的包环境 + 命名约定 + 配置项三者同时满足才触发的。少一个环节,它就当你没写测试——不是它坏了,是你没喂对信号。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
pycharm怎么改成中文
pycharm怎么改成中文

PyCharm是一种Python IDE(Integrated Development Environment,集成开发环境),带有一整套可以帮助用户在使用Python语言开发时提高其效率的工具,比如调试、语法高亮、项目管理、代码跳转、智能提示、自动完成、单元测试、版本控制。此外,该IDE提供了一些高级功能,以用于支持Django框架下的专业Web开发。php中文网给大家带来了pycharm相关的教程以及文章,欢迎大家前来学习和阅读。

2023.07.25

2569

3

pycharm安装教程
pycharm安装教程

PyCharm是一款由JetBrains开发的Python集成开发环境(IDE),它提供了许多方便的功能和工具。本专题为大家带来pycharm安装教程,帮助大家解决问题。

2023.08.21

4817

4

如何解决pycharm找不到模块
如何解决pycharm找不到模块

解决pycharm找不到模块的方法:1、检查python解释器;2、安装缺失的模块;3、检查项目结构;4、检查系统路径;5、使用虚拟环境;6、重启PyCharm或电脑。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.12.04

738

5

如何安装pycharm
如何安装pycharm

安装pycharm的步骤:1、访问PyCharm官方网站下载最新版本的PyCharm;2、下载完成后,打开安装文件;3、安装完成后,打开PyCharm;4、在PyCharm的主界面中等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

774

5

python和pycharm的区别
python和pycharm的区别

Python和PyCharm是两个不同的概念,它们的区别如下:1、Python是一种编程语言,而PyCharm是一款Python集成开发环境;2、Python可以运行在各种不同的开发环境中,而PyCharm是专门为Python开发而设计的IDE等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

507

5

pycharm环境如何配置
pycharm环境如何配置

配置教程:1、下载并安装PyCharm;2、选择Python解释器;3、配置虚拟环境;4、配置代码风格;5、配置调试器;6、配置版本控制工具;7、配置插件;8、配置Python路径和环境变量;9、配置其他选项。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

502

5

pycharm解释器如何安装
pycharm解释器如何安装

安装步骤:1、打开PyCharm并打开你的项目;2、转到"File">“Settings”;3、在设置窗口中选择"Project">“Python Interpreter”;4、 点击“+” 符号添加新的解释器等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

323

5

pycharm并行运行是啥意思
pycharm并行运行是啥意思

pycharm中的并行运行功能允许并发运行代码块,提高开发和测试效率。通过启用该功能和设置进程数,可以:加快开发和调试过程;缩短测试套件的运行时间;充分利用多核处理器;简化复杂代码的结构和维护。想了解更多pycharm的相关内容,可以阅读本专题下面的文章。

2024.04.18

1168

11

pycharm的作用
pycharm的作用

pycharm是一款专为python编程设计的ide,提供以下功能:智能代码补全,实时错误检测和快速修复;代码重构,版本控制集成,先进调试工具等等。想了解更多pycharm的相关内容,可以阅读本专题下面的文章。

2024.04.18

5276

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程