PyCharm 中 pytest 运行 python 测试文件报错:D:\Python_file\.venv\Scripts\python.exe: No module named pytest

现象

在 PyCharm 中打开需要用 pytest 工具进行测试的 python 测试文件路径下,执行 "pytest" 或 "python -m pytest" 都提示 "No module named pytest",无法正常使用 pytest 测试。

尝试解决过程

按照《Python编程:从入门到实践》书中指示,"Win + R" 键进入 cmd 命令行终端。

  1. 执行 "python -m pip install --user pytest",安装的 pytest 在 C:\Users\admin\ 下某一目录。

(怀疑是与 python 测试文件未在同一盘符下,于是执行第 2 步)

  1. "python -m pip uninstall pytest",卸载原来安装在 C 盘下的 pytest。

"python -m pip install --target D:\Pytest\ pytest",安装 pytest 到 D 盘下新建的 Pytest 目录下。

(再次在测试文件路径下运行pytest,依旧报同样的错误)

直接删除 D:\Pytest 整个文件夹,以卸载无用的 pytest 安装。

  1. "python -m pip install --target D:\Python_file\ pytest",直接安装 pytest 到测试代码同目录下。

此时输入 "pytest" 还是不行,输入 "python -m pytest" 能执行。

但发现 pytest 除了测试代码中写的 "test_xxx.py" 文件,还会执行很多其他测试文件。

collected 53 items,实际上只想测试 1 item(可与最后 "pytest 工具正常测试效果" 图对比)。

测试代码目录下也多出很多其他文件。

直接到测试代码目录下,删掉除之前 .venv 目录和自己写的 .py 文件外多出的文件和文件夹,以卸载无用的 pytest 安装。

原因

PyCharm 编辑器中编译 Python 项目,其实是在 venv 虚拟环境下。

要在这个虚拟环境下安装 pytest,正常 Windows 系统下安装的 pytest 是读取不到的。

解决办法

  1. 先 activate 激活虚拟环境。(激活后命令行提示符有所不同,再输入命令时也有不同的颜色提示)
  1. 激活后在此环境下,最好先更新 pip,版本太旧的 pip 可能导致之后安装 pytest 失败。
  1. 在此环境下正确安装 pytest。

我这里已经安装过了,正常安装成功会出现如 "Successfully installed pytest-8.4.1" 的提示。

  1. 也可以检查 pytest 版本,确认是否安装成功了。

pytest 工具正常测试效果

  1. 每次重新打开终端,最好先重新 activate 激活虚拟环境。
  1. 直接执行 "pytest"。
  1. 正常测试编写的 "test_xxx.py" 文件。

补充

  1. 按照上述方法安装在 venv 虚拟环境下的 pytest,是只针对于当前项目的虚拟环境的。

如果换了另一个项目,就相当于是换了一个整体环境,那么对于新项目的虚拟环境,里面还是没有 pytest 工具的,需要重新激活环境,重新在新的项目虚拟环境下安装 pytest。

  1. 或者按照 "尝试解决过程" 1,直接安装 pytest 到系统下,需要测试项目时,在系统终端内切换到项目路径,以系统中安装的 pytest 工具去运行项目中的测试代码文件。

【如果只是需要运行 pytest 测试某一项目,选择 2 更方便】

【如果要在代码中 import pytest 相关的库,必须选择 1,只有在项目虚拟环境中安装,才能在代码中 import 到】

虚拟环境中安装前:

虚拟环境中安装后:

相关推荐
最强小杰4 小时前
Claude Opus 4.8 调用报 529 怎么办?并发限制触发过载——退避策略与降级方案完整指南
运维·网络·python·ai
databook4 小时前
MinMax vs Standard vs Robust:三种特征缩放怎么选
python·机器学习·数据分析
我科绝伦(Huanhuan Zhou)4 小时前
磐维数据库(PanWeiDB)日常运维命令总结
运维·数据库
在世修行4 小时前
智学文枢:实体模型层
python·orm·sqlalchemy
深盾科技_Virbox4 小时前
软许可、加密锁和云许可混合使用时,授权接口应该怎么统一?
运维·网络·安全
逐流人4 小时前
Redis内存数据库:从数据类型到集群部署
linux·运维·数据库·redis·缓存·云计算
知识分享小能手4 小时前
C学习教程,从入门到精通,C语言指针 —— 详细知识点总结(10)
c语言·开发语言·学习
熊猫钓鱼>_>4 小时前
开源鸿蒙平台 KMP 三方库 kotlin-csv 适配全流程:从编码假设到沙箱真机互通验证
开发语言·人工智能·华为·kotlin·harmonyos·鸿蒙
张张123y4 小时前
# 后端第七课:FastAPI 实战入门(用刚学的 Python 写第一个 API 接口)
开发语言·python·mysql·api·fastapi
CCblandy4 小时前
一致性哈希到底省了多少搬迁?本机实测 3 轮:取模 6→7 搬 85.8%,V=128 只搬 14.3%,虚拟节点太少会被倾斜骗
后端·python·云原生·性能优化·架构