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 模块名
posted @ 2025-05-11 14:12  LGCR837  阅读(124)  评论(0)    收藏  举报