Python安装第三方库的四种常用方法及避坑指南

前言

在Python学习过程中，第三方库的安装往往是初学者面临的第一个难题。许多人在此环节容易遇到各种报错，导致进度受阻。为了帮助大家少走弯路，本文基于实际踩坑经验，系统梳理了正确且高效的第三方库安装策略，便于日后回顾与查阅。

安装方法

1. 通过PyCharm安装

这是操作最直观便捷的方式，但同时也是最容易因环境配置问题导致报错的方法。

在PyCharm中，依次点击 File（文件） > Settings（设置） > Project（项目） > Python Interpreter（Python解释器）。

在此界面可查看当前已安装的第三方库及其版本号。点击下方的加号图标即可添加新库。以安装numpy为例，在搜索框中输入库名，右侧可选择具体版本（默认不勾选即为最新版），最后点击 Install Packages 按钮完成安装。

2. pip安装大法

若在PyCharm中安装失败，或未使用PyCharm作为开发工具，可以直接使用pip命令行工具进行安装。

首先打开命令提示符（cmd），直接输入pip install 你想要安装的第三方库（此处仍以numpy为例）。

此外，补充一些关于pip管理包的常用操作指令：

（1）升级pip自身

py -m pip install --upgrade pip

（2）pip安装、卸载及升级操作

pip install 包名              #安装
pip uninstall 包名            #卸载
pip install --upgrade 包名    #升级

（3）查看已安装的包列表

pip list

（4）检查哪些包需要更新

pip list --outdated

（5）查看特定包的详细信息

pip show 包名

（6）安装指定版本的包

pip install 包名==版本号
例如：
pip install numpy==1.20.3
pip install 'matplotlib>3.4'
pip install 'matplotlib>3.4.0,<3.4.3'  #可通过使用==, >=, <=, >, <来指定版本号

3. 下载whl文件到本地离线安装

如果前两种在线安装方式均告失败，推荐尝试第三种离线安装法。虽然操作稍显繁琐，但亲测有效且极少报错。访问网站https://www.lfd.uci.edu/~gohlke/pythonlibs/，搜索并找到需要下载的库。以matplotlib为例： 首先，务必注意该库依赖的其他前置库，必须先安装这些依赖库，否则直接安装主库会报错。 同时，在更新某个库时，也需同步检查并更新其依赖库，以避免版本冲突引发的错误。

随后，根据你的Python版本及系统位数（如32位或64位）选择对应的whl文件下载。例如，若Python版本为3.7.9且为64位系统，则选择 matplotlib‑3.5.1‑cp37‑cp37m‑win_amd64.whl。

将下载好的whl文件保存至指定文件夹Python37\Lib\site-packages，在该文件夹路径下打开cmd，输入pip install whl文件名即可执行安装。

3.1 补充说明

在安装过程中，大部分失败案例均源于未安装对应的依赖包。因此，遇到报错时，务必及时检查相关依赖包是否已安装，并同步进行版本更新。

例如，我曾遇到如下错误：AttributeError：module ‘matplotlib’ has no attribute ‘get_data_path’ ，困扰许久无法解决，最终发现是matplotlib依赖的某个子库未正确安装所致。

4. 其他方法

4.1 Python官方Pypi菜单

直接访问官方仓库搜索第三方库进行安装，网址为：https://pypi.org/

4.2 国内镜像源解决pip安装过慢的问题

在Windows系统下，安装第三方库时常遇超时或下载缓慢，原因在于Python官方服务器位于国外。此时建议使用国内镜像源加速安装。

安装方法：在cmd中添加“-i”或“–index”参数指定镜像地址。以numpy为例：`pip install -i https://pypi.tuna.tsinghua.edu.cn/simple numpy`

常用的几个国内镜像源地址如下：

• 清华大学：https://pypi.tuna.tsinghua.edu.cn/simple
• 阿里云：http://mirrors.aliyun.com/pypi/simple/
• 中国科学技术大学：https://pypi.mirrors.ustc.edu.cn/simple/
• 豆瓣：https://pypi.douban.com/simple

小结

对于大多数新手而言，Python第三方库的安装确实是初学路上的“拦路虎”，我也曾为此头疼不已。就个人实测经验来看，前三种方法均有效。第一种和第二种最为简单直接，但容易因不熟悉包间依赖关系而出错。因此，强烈建议：若前两种方法安装不成功，请务必尝试第三种离线安装法！务必看清安装所需第三方库的前置依赖包，否则极易安装失败。第四种方法（官方Pypi及镜像源）虽未频繁使用，但前三种已能覆盖绝大多数安装需求；若有需要，也可进一步了解第四种方法，此处不再赘述。

总结

至此，关于Python安装第三方库的常用方法介绍完毕。更多相关Python安装第三方库内容，请搜索本站历史文章或继续浏览后续相关文章。希望大家以后多多支持本站！