Python第三方模块(库、包)安装、卸载与查看及常见问题解决（修订）

Python第三方模块(库、包)安装、卸载与查看及常见问题解决（修订）

预备知识：cmd的打开与使用

cmd的打开：按下win键+R键（即先按下 键，再按下R键）或 右击“开始”－>单击“运行”，弹出“运行”窗口，参见下图：

 关于cmd 详情可参见： CMD和PowerShell介绍 https://blog.csdn.net/cnds123/article/details/80781305

Python中的模块（Module）、包（package）和库（library）是什么意思？

Python 模块(Module)，是一个 Python 文件，以 .py 结尾，包含了 Python 对象定义和Python语句。或者说是 Python 代码的一种组织单位。

多个模块放在一个文件夹，就是一个包（package）。在早一点的 Python 版本（Python 3.3 之前）中，如果一个文件夹下有一个 __init__.py 文件，那我们就称之为包。在后来的 Python 版本（Python 3.3 开始）中，就没有这个要求了，只要是文件夹就可以当作包（package），简单地说，包由相关目录里的模块构成。

python中的库（Library）是参考其它编程语言的说法，既可以是一个模块也可以是一个包，是对模块或包的通俗的说法。

在Python中，模块分为三种：

标准模块【注1】，打开你的Python解释器目录，标准模块就在Lib文件夹下

第三方（扩展）模块【注2】，第三方模块被统一的存放在本地Python安装路径的Lib/site-packages文件夹内

自定义模块，就是我们自己写的模块了（可参见 python中的自定义模块及其使用 https://blog.csdn.net/cnds123/article/details/107087019 ）

【注1】Python将常用的实现某类功能的代码组织在一起并起名为模块，随着Python解释器安装到你的本地，称为标准模块。

【注2】需要Python做的事情实在是太多了，不可能把所有的模块都预先安装。使用Python的人们根据特定的应用场景开发出了特定用途的模块，这些模块经过Python官方审核通过，就可以被广大Python开发者使用了，这种现成的并未随着python解释器安装的模块被统称为第三方模块。第三方模块在首次使用前必须安装之。

Python模块(库、包)安装方法

在CMD中（Windows命令行窗口中），输入如下的命令：

pip install 模块(库、包)名

如安装numpy

pip install numpy

如果你的电脑上安装了多个Python版本，你可以为特定版本的Python安装模块（库、包），有多种方式：

1、在cmd中（命令行中）使用 py 启动器命令配合 -m 开关选项，为指定Python版本安装模块（库、包）：

py -X.Y -m pip install 模块(库、包)名

其中

X.Y代表Python版本，多余的部分舍弃如3.7.4，取3.7，3.8.1取3.8，3.10.5取3.10，即只取第二个点前的部分。

py 是启动器py.exe，Python启动器（Launcher）可帮助定位和执行不同版本的Python解释器。在Windows中安装Python时，默认安装Python启动器（py.exe）。

2、在命令行中先进入特定版本的Python安装路径，再使用如下命令：

pip install 模块(库、包)名

【查看Python安装路径方法，在cmd中使用命令

py -0p

其中0是零。

用于显示已安装的 Python 版本信息。其中带星号*的为默认版本。

查看Python安装路径几种方法 https://blog.csdn.net/cnds123/article/details/101546889 】

3、使用完整的Python路径安装，这样即使安装了多个python3版本也不会混淆，格式为：

安装路径\python.exe -m pip install 模块(库、包)名 ，如：

D:\Python\Python310\python.exe -m pip install numpy

如何升级已安装的 第三方模块(库、包)？

pip install --upgrade第三方模块(库、包)名

如果你的电脑上安装了多个Python版本，你想为特定版本的第三方模块（库、包）升级，参照上面处理。

其它强制重新安装Python模块(库、包)名使用技巧如下

☆ 卸载后再安装：如果需要彻底清理旧版本并重新安装，可以先卸载再安装：
pip uninstall 模块(库、包)名
pip install 模块(库、包)名

☆ 使用--force-reinstall选项
此选项用于强制重新安装指定的模块(库、包)名，即使它已经是最新的版本。它会重新安装模块(库、包)名，但不会升级到最新版本。
pip install --force-reinstall 模块(库、包)名

☆ 指定版本重新安装：如果需要重新安装特定版本，可以使用：
pip install 模块(库、包)名==特定版本号 --force-reinstall

☆ 使用--no-deps选项
此选项用于安装模块(库、包)名时忽略其依赖关系。它只重新安装模块(库、包)名本身，不会重新安装或检查依赖。此选项只修复模块(库、包)名本身，而不影响依赖，使用时需谨慎。
pip install --no-deps 模块(库、包)名
 

python如何验证某个模块是否安装成功？

使用import语句导入模块，并不抛出异常：

import 模块名

具体而言，在Python 的IDEL Shell中用import 模块 回车，如果没有出现红字就说明安装成功。 详见https://blog.csdn.net/cnds123/article/details/103643642

Python模块(库、包)安装命令常用格式小结：

[py -X.Y -m] pip install [-i 镜像网址] 模块(库、包)名

其中[]部分表示可选的

若安装了多个python版本，X.Y代表Python版本，多余的部分舍弃如3.8.1取3.8，3.10.5取3.10，即只取第二个点前的部分。仅安装了一个python版本不需要。

pip命令默认会连接在国外的python官方服务器下载，速度可能比较慢，使用镜像网址可以加快速度。常用的国内镜像网址如下：
清华：https://pypi.tuna.tsinghua.edu.cn/simple
阿里云：https://mirrors.aliyun.com/pypi/simple/
中国科技大学 https://pypi.mirrors.ustc.edu.cn/simple/

【 顺便提示：安装模块时，若提示：Could not install packages due to an EnvironmentError: [WinError 5] 拒绝访问。添加--user选项赋予权限，以安装pillow为例：

py -3.7 -m pip install pillow --user 】

参考、官方说明https://docs.python.org/zh-cn/3/installing/index.html

卸载已安装模块(库、包)的方法

在cmd中，输入如下的命令：

pip uninstall 模块(库、包)名

如卸载numpy

pip uninstall numpy     

若安装了多个python版本，卸载由X.Y指定python版本关联的模块(库、包)：

py -X.Y -m pip uninstall  模块(库、包)名

查看已安装的第三方模块（库、包）及其版本号

在cmd中，输入如下的命令：

pip list

若安装了多个python版本，查看由X.Y指定python版本关联的模块(库、包)情况：

py -X.Y -m pip list

其中，list也可换为 freeze

查看某个具体的第三方模块(库、包)的安装完整路径

当计算机中安装了多个版本的 Python 时， 查看某个具体的第三方模块(库、包)的安装完整路径，在命令行中运行where 命令：

where模块(库、包)名

例如：where pyinstaller 可能显示如下

D:\Python39\Scripts\pyinstaller.exe
D:\Python310\Scripts\pyinstaller.exe

说明：系统中安装了多个 PyInstaller，where 命令会列出所有路径。

验证模块（库、包）是否安装或是否安装成功

在Python 的IDEL Shell中用import 模块（库、包）名  回车，如果没有出现红字就说明安装成功。否则就是未安装或是未安装成功

如想验证模块包matplotlib是否安装或是否安装成功

import  matplotlib

​

离线安装

先将模块(库、包)下载，再安装之步骤：

python库离线安装文件扩展名是whl

.打开PyPI · The Python Package Index，搜索下载。

上面这个网址下载速度较慢，也可在清华的镜像中下载，链接是：Simple Index (tsinghua.edu.cn)

.搜索（CTRL+F）需要安装的库的名称，比如pandas

找到对应自己系统的版本并下载，cp后面的数字时python的版本，如cp36代表python3.6版本，WIN后面的数字32/64表示32或者64位系统；参见下图：

​

下载后，在cmd中使用pip install +路径文件名安装，例如

pip install c:\pandas‑0.23.4‑cp36‑cp36m‑win_amd64.whl

如果你的计算机上安装有多个python版本，可在cmd中，先用cd命令切换到其安装目录（我这里是D:\Python\Python36）的Scripts目录中，cd /d D:\Python\Python36\Scripts，再输入前面的pip命令

提示：在线安装如果出现问题，可以试试离线安装扩展库。

常见问题解决

1、cmd中使用python -m pip install --upgrade pip 升级不成功怎么办？

问题描述： install 库时，有时提示 ，You should consider upgrading via the 'python -m pip install --upgrade pip' command.（您应该考虑通过'python-m pip install--upgrade pip'命令进行升级。），但在cmd中使用python -m pip install --upgrade pip 升级不成功，提示：

ERROR: Exception:
Traceback (most recent call last): ……
（中文意思：错误：异常：
回溯（最近一次呼叫）：……）

怎么办？

问题产生原因与解决：

这是因为服务器连接超时，可使用-i开关选项添加镜像（在此豆瓣镜像为例https://pypi.douban.com/simple）网址可解决，如（在cmd中使用）：

python -m pip install --upgrade pip -i https://pypi.douban.com/simple

2、安装库时，cmd中使用pip install 库名 ，超时报错怎么办？

如在cmd中安装库（在此以xlwings库为例），pip install xlwings ，不成功，提示：

ERROR: Exception:
Traceback (most recent call last): ……
（中文意思：错误：异常：
回溯（最近一次呼叫）：……）

怎么办？

问题产生原因与解决：

这个问题产生的原因和上面一样，因为服务器连接超时，可使用-i开关选项添加镜像（在此豆瓣镜像为例https://pypi.douban.com/simple）网址可解决，如（在cmd中使用）：
pip install -i https://pypi.douban.com/simple/ xlwings

国内镜像源：

国内镜像	地址
阿里云	https://mirrors.aliyun.com/pypi/simple/
豆瓣	https://pypi.douban.com/simple/
清华大学	https://pypi.tuna.tsinghua.edu.cn/simple/

3、在cmd中安装模块（库、包）（假设名XX），不成功，提示：

ERROR: Could not find a version that satisfies the requirement XX  
ERROR: No matching distribution found for XX

怎么办？

问题产生原因与解决：

在看网络是否稳定，用-i开关选项添加镜像试试（详见问题2），若还不行，要考虑是否Python版本和第三方模块(库、包)不兼容，特别是在使用最新Python版本时，使用以前的Python版本试试，若安装了多个Python版本，需要用”py -X.Y -m ”（详见前面） 。

4、遇到“拒绝访问”的出错信息，可在执行pip命令时增加选项--user

提示：本文可以结合这篇博文学习：python模块（库、包）的查看、安装与验证 https://blog.csdn.net/cnds123/article/details/103643642

 

附录：关于安装Python的几点说明

安装 Python 时，最好勾选下 "Add python.exe to PATH" 这个选项。这个选项的作用是将 Python 的安装路径添加到系统的环境变量 PATH 中。一旦 Python 路径被添加到 PATH 环境变量中，这意味着你可以在任何命令行窗口（如 CMD 或 PowerShell）中直接运行 python 或 pip 命令，而无需指定 Python 可执行文件的完整路径或切换到 Python 的安装目录。

如果你安装了多个 Python 版本，在cmd下输入python打开的python程序的版本，取决于环境变量的用户变量的path变量里哪个版本的python路径更靠前。

否则需要使用完整路径才能运行特定版本的 Python，例如上图所示的Python3.12：

D:\Python\Python312\python.exe

查看当前python默认版本，在cmd下输入

python -–version