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 到】

虚拟环境中安装前:

虚拟环境中安装后:

相关推荐
从零开始的代码生活_6 小时前
C++ 继承详解:访问控制、对象模型、菱形继承与设计取舍
开发语言·c++·后端·学习·算法
云小逸6 小时前
【C++ 第七阶段:模板、泛型编程与工程综合详解】
开发语言·c++
C^h6 小时前
python函数学习
人工智能·python·机器学习
生活爱好者!6 小时前
我把NAS当作下载机,docker一键部署qb
运维·docker·容器
Fanta丶6 小时前
4.Python set()集合、dict(字典、映射)、 数据容器的通用功能
python
决战灬6 小时前
langgraph之interrupt(理论篇)
人工智能·python·agent
GIS阵地6 小时前
QgsSingleBandPseudoColorRenderer 完整详解(QGIS 3.40.13 C++)
开发语言·前端·c++·qt·qgis
兜客互动6 小时前
2026年AI关键词拓展挖掘软件,高效助力内容创作精准获流
人工智能·python
weixin_538601976 小时前
智能体测开Day30pytest测试框架
python
MC皮蛋侠客6 小时前
uv 系列(七):CI/CD、Docker 与私有索引——生产级交付
python·ci/cd·docker·uv