Python导入模块报错?保姆级教你如何正确安装模块
一些刚学Python的新手可能会遇到下面的问题:
Traceback (most recent call last):
File "xxxxx.py", line x, in <module>
import asdjk
ModuleNotFoundError: No module named 'xxxxx'
Exited with error status x
这说明你的程序里的一些代码没有安装对应的模块,因为一些模块是 Python 本身不自带的,需要手动安装。本文章的目的:
本教程针对 Windows 操作系统的 Python3 编写,其他操作系统和Python版本略有不同
安装模块
首先打开按住电脑的Windows (左下角那个四方块键)
+ R
,会弹出一个名为运行
的窗口,输入cmd
并点击运行或按回车,这时候会弹出一个黑乎乎的窗口,这就是命令提示符 (cmd)
。
随后在这个窗口中输入(将xxxxx替换为你想要安装的模块,就是代码里 import xxxxx 的那个)
pip install xxxxx
当然先别着急,因为 pip 安装的服务器在国外,所以下载会很慢。下面会教你使用国内镜像服务器加速下载。
使用国内镜像源
国内有很多的 pip 镜像源,可以加速 pip 的下载,使用方式如下。
临时使用:
pip install xxxxx -i 镜像源地址
永久设置,一劳永逸:
pip config set global.index-url 镜像源地址
常见的镜像源: (推荐阿里云,最稳定)
清华源 https://pypi.tuna.tsinghua.edu.cn/simple
阿里云 http://mirrors.aliyun.com/pypi/simple/
中科大 https://pypi.mirrors.ustc.edu.cn/simple/
华中理工大学 http://pypi.hustunique.com/
山东理工大学 http://pypi.sdutlinux.org/
豆瓣 http://pypi.douban.com/simple/
例: 永久设置为 阿里云:
pip config set global.index-url http://mirrors.aliyun.com/pypi/simple/
通过文件安装模块
进入文件所在目录,是点击地址栏,输入cmd
并回车,然后输入这个并按回车:
pip install 你的文件(别忘记加后缀)
这个仅用于 whl 和 tar.gz 文件。
解决 pip 报错
"pip" 不是内部或外部命令,也不是可执行文件或批处理程序
可能1 - 没有配置环境变量
临时解决:
右键你桌面上或开始菜单里的 Python 软件图标,点击打开文件所在位置
(如果进去不是一大堆文件就还要继续在打开的文件夹里如上操作),进入Python目录,再打开Scripts
文件夹,点击上方地址栏后输入cmd
按回车,然后执行之前步骤。
永久解决: (不同Windows系统不同,自行百度解决)
将Scripts
文件夹添加到环境变量。
可能2 - pip 未安装
方法1:
按最开始的方法打开cmd,输入:
python -m ensurepip --default-pip
然后等待安装完毕。
方法2:
用浏览器打开https://bootstrap.pypa.io/get-pip.py,浏览器会把这个文件下载下来,如果浏览器没有下载而是显示出来,请按Ctrl
+ S
保存。确保文件名为get-pip.py
。
下载完毕后进入文件下载的文件所在目录,依旧是点击地址栏,输入cmd
并回车,然后输入:
python get-pip.py
然后等待安装完毕。
安装时提示更新
如果安装模块时提示下面的内容,就说明你的 pip 版本太老了,需要更新
[notice] A new release of pip is available: 23.0 -> 24.0
[notice] To updata, run: python.exe -m pip install --upgrade pip
可以直接按照上面最后一行的提示,输入:
python.exe -m pip install --upgrade pip
不存在的模块
如果依然报错,请检查一下到底有没有这个模块,是不是输错了。
如果这个模块是近几天才有的,或这个模块非常冷门,国内的镜像源可能没有及时更新或收录,可以用下面命令将 pip 换成官方源。
pip config unset global.index-url
网络问题
检查电脑是否连接网络,或者可以试着按上面的教程配置国内的镜像源,或者更换镜像源(因为很多镜像源都不太稳定)。
常见 pip 命令
查看已安装模块
pip list
查看模块安装路径
pip show 模块名
卸载模块
pip uninstall 模块名
查看可更新模块
pip list -o
升级模块
pip install -U 模块名
注意U
大写。
(新版已废弃不可用)搜索模块
pip search 模块名