现象
在 PyCharm 中打开需要用 pytest 工具进行测试的 python 测试文件路径下,执行 "pytest" 或 "python -m pytest" 都提示 "No module named pytest",无法正常使用 pytest 测试。
尝试解决过程
按照《Python编程:从入门到实践》书中指示,"Win + R" 键进入 cmd 命令行终端。
- 执行 "python -m pip install --user pytest",安装的 pytest 在 C:\Users\admin\ 下某一目录。

(怀疑是与 python 测试文件未在同一盘符下,于是执行第 2 步)
- "python -m pip uninstall pytest",卸载原来安装在 C 盘下的 pytest。

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


(再次在测试文件路径下运行pytest,依旧报同样的错误)
直接删除 D:\Pytest 整个文件夹,以卸载无用的 pytest 安装。
- "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 是读取不到的。
解决办法
- 先 activate 激活虚拟环境。(激活后命令行提示符有所不同,再输入命令时也有不同的颜色提示)

- 激活后在此环境下,最好先更新 pip,版本太旧的 pip 可能导致之后安装 pytest 失败。

- 在此环境下正确安装 pytest。

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

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


pytest 工具正常测试效果
- 每次重新打开终端,最好先重新 activate 激活虚拟环境。

- 直接执行 "pytest"。

- 正常测试编写的 "test_xxx.py" 文件。

补充
- 按照上述方法安装在 venv 虚拟环境下的 pytest,是只针对于当前项目的虚拟环境的。
如果换了另一个项目,就相当于是换了一个整体环境,那么对于新项目的虚拟环境,里面还是没有 pytest 工具的,需要重新激活环境,重新在新的项目虚拟环境下安装 pytest。
- 或者按照 "尝试解决过程" 1,直接安装 pytest 到系统下,需要测试项目时,在系统终端内切换到项目路径,以系统中安装的 pytest 工具去运行项目中的测试代码文件。

【如果只是需要运行 pytest 测试某一项目,选择 2 更方便】
【如果要在代码中 import pytest 相关的库,必须选择 1,只有在项目虚拟环境中安装,才能在代码中 import 到】
虚拟环境中安装前:

虚拟环境中安装后:

