无法将“pytest”项识别为 cmdlet、函数、脚本文件或可运行程序的名称
pytest 已安装且可以通过绝对路径运行,但无法通过命令行直接调用 pytest 命令
已找到绝对地址且添加至环境变量,经过测试,使用绝对地址运行可正常返回结果,但通过环境变量运行pytest无法返回结果,说明 pytest 的安装目录没有正确添加到系统 PATH 环境变量中。
解决方案
方法1:将 pytest 所在目录添加到 PATH
- 找到 pytest 的可执行文件位置:
- 通常位于
C:\Users\用户名\AppData\Roaming\Python\Python312\Scripts\
- 或者在 Python 安装目录的 Scripts 子目录中
- 将此目录添加到系统 PATH 环境变量:
-
打开"系统属性" > “高级” > “环境变量”
-
在"系统变量"中找到 Path 变量,点击"编辑"
-
添加新条目:
C:\Users\用户名\AppData\Roaming\Python\Python312\Scripts\
- 或者
C:\Program Files\Python312\Scripts\
(取决于您的 Python 安装位置)
- 保存更改并重新打开命令提示符
方法2:使用 Python 模块方式运行
您也可以使用以下命令替代直接运行 pytest:
python -m pytest
这种方式会通过 Python 模块系统查找 pytest,不需要 PATH 配置。
方法3:重新安装 pytest 并确保添加到 PATH
- 卸载现有 pytest:
pip uninstall pytest
- 重新安装并确保添加到 PATH:
pip install pytest
-
安装时 pip 通常会提示是否将脚本目录添加到 PATH。
-
验证
完成上述任一方法后,打开新的命令提示符窗口,输入:
pytest --version
应该能正确显示 pytest 版本信息。
- 如果重新安装时提示:
pytest 的可执行文件 (pytest.exe 和 py.test.exe) 已安装在C:\Users\用户名\AppData\Roaming\Python\Python312\Scripts 目录,但该目录不在系统的PATH 环境变量中。
-
将 Scripts 目录添加到 PATH
-
在"用户变量"或"系统变量"部分找到 Path 变量
-
点击"编辑" → “新建”
-
添加路径:C:\Users\wyt\AppData\Roaming\Python\Python312\Scripts
-
-
判断path是否生效
- 在powershell里输入:
echo $env:PATH
返回的结果内有刚刚添加的路径则说明路径添加成功;
- 需要确定修改 PATH 后未重启终端或未刷新环境变量
如果问题仍然存在,请检查:
-
是否正确识别了 pytest 的实际安装位置
-
是否在修改 PATH 后打开了新的命令提示符窗口(环境变量更改需要重新加载);如在pycharm需要重开终端窗口仍无法通过命令运行pytest,需要重启pycharm
-
.是否有多个 Python 安装导致冲突