Python库的安装问题

所遇问题与解决方式

本人在安装Python库时遇到了许多报错，花了两天的时间找原因和解决方式，在阅读了许多前辈的教程贴之后、终于解决了问题。在此感谢知识共享的朋友们，另将过程记录以备后用。
注：文中"程序库"、“程序包”、“安装包”、“模块”均指的是Python程序库。本人第一次写文章，如有不足之处敬请谅解、如有错误请评论区指出。欢迎朋友们一起交流学习！

安装版本

Python：3.8.10
Pycharm：2019.3.3
pip： 22.1（官方最新版）

1 Pycharm安装gdal库失败

1.1 错误一：缺少VC++14环境

错误原因提示：“Microsoft Visual C++ 14.0 is required”
解决办法：
（1）安装 Microsoft Visual C++ Build Tools。可以根据网上教程进行安装。
（2）但在实际安装时总会出现“安装包丢失或损坏”的问题，建议直接下载离线包、在“请提供搜索包的位置”中直接选择 .msi 文件。（详见参考文章一）

1.2 错误二：安装VC++14.0后，再在pycharm中安装库依然报错

错误原因提示：“cl.exe 已退出，代码为 2 ” 或 “Non-zero exit code (2)”。
解决办法：
（1）cl.exe 的问题在网上找了很多教程，尝试了一些都没有效果。
（2）感觉我的Pycharm是一种 " 我今天就是die,你也别想通过我安装成一个库! " 的坚决……所以只能从 pip 进行安装了。

2 pip 安装库

2.1 Python程序库下载地址

https://www.lfd.uci.edu/~gohlke/pythonlibs/

按字母顺序查找就好。以 gdal 库为例，第一个箭头处指的是 gdal 库的版本、越大越新；第二个箭头处指的是适配的Python的版本，如cp310即适用于Python3.10版本；最后一个箭头指适配的电脑系统 （64位/32位）。

2.2 通过Pip下载程序包

2.2.1 首先保证已经安装了pip, 尽量更新到最新版本 以免某些库安装失败
检查方式：可以通过以下命令来判断

pip --version     # Python2.x 版本命令
pip3 --version    # Python3.x 版本命令

升级pip：

pip install -U pip

2.2.2 pip安装库命令
(1) 安装库：
在Python安装目录的文件夹路径中输入‘cmd’，回车，在弹窗中输入以下命令，直接安装。

pip install SomePackage
eg： pip install gdal 

(2) 卸载库：

pip uninstall SomePackage

(3) 升级库：

pip install --upgrade SomePackage

(4) 中阶命令：无需手动下载 .whl 文件。 使用镜像网站自动下载 .whl 文件并安装所需库：

pip install 模块名 -i https://pypi.tuna.tsinghua.edu.cn/simple     # pip 清华大学开源软件镜像站
pip install 模块名 -i http://pypi.douban.com/simple --trusted-host pypi.douban.com  # pip 豆瓣开源软件镜像站
eg：pip install gdal -i https://pypi.tuna.tsinghua.edu.cn/simple 

(5) 高阶命令：下载 模块名.whl 文件，并放置在Python安装目录下的“scripts”文件夹中，并在Python安装目录的文件夹路径中输入‘cmd’，回车，在弹窗中输入以下命令进行安装。

pip install 模块名.whl
eg：pip install GDAL-2.2.4-cp36-cp36m-win_amd64.whl

2.3 Pip命令下载程序包在Python和Pycharm中不通用的问题

我在Python安装路径下 通过pip命令安装库时，发现在Pycharm中并没有自动同步，即没有&不能使用。

我的Python安装路径：D:\Program Files\Python38\Scripts
Pycharm安装路径：D:\Program Files\JetBrains\PyCharm 2019.3.3

解决办法一：
参考这位博主：关于python在cmd下pip安装的包在pycharm不可用问题的解决方法
这样在Python安装路径下pip安装的库就在Pycharm中也能自动同步啦，可以使用。

解决办法二：
在Pycharm安装路径下再装一遍，这样装的库才会出现在Pycharm中。
不过个人还是推荐第一种，但是方法一每次只解决一个项目的问题，不同的项目要按照该方法都设置一遍才生效。

链接:
参考文章一.
参考文章二.
参考文章三.