【python基础】—离线环境下，在linux中安装python包（以sqlalchemy为例）

---

第一步：在线环境下载离线安装包及依赖包。

下载第三方库官网：https://pypi.org/，进入官网搜索要安装第三库名，选择合适的版本。本文以安装sqlalchemy库为例。

注意版本选择，否则会报错。
执行命令 “python -m pip debug --verbose” 查看pip支持的文件名和版本了，下载包含其中一个的版本即可，例如：安装sqlalchemy的包名称含有 “cp310-cp310-manylinux_2_17_x86_64” 即可。

第二步：把包上传到离线环境的服务器上，进行安装。

将下载的包上传到site-packages目录的路径，如果不知道具体，可以执行下面的语句，查看路径。

# 通过Python的site模块获取site-packages目录的路径
import site
print(site.getsitepackages())

有两种安装方式。

• 对于.whl文件，直接运行下面的命令进行安装。
  • pip install *.whl文件

pip install SQLAlchemy-2.0.32-cp310-cp310-manylinux_2_17_x86_64.whl

• 对于.tar.gz文件，按照下面的步骤进行安装。
  • 1、解压安装包 tar -zxvf *.tar.gz
  • 2、解压完成后，进入解压后的目录 cd *
  • 3、使用setup.py文件进行安装：python setup.py install

第三步：测试是否安装成功。

在python包安装成功后，可以从python控制台中验证其是否安装成功。

• 1、运行 python 命令。
• 2、import package_name。

如果这个命令没有报错就是该包已经成功安装。

---

常见报错之版本选择问题

报错： is not a supported wheel on this platform.

原因： *.whl版本pip不支持。

1、执行命令 “python -m pip debug --verbose” 查看pip支持的文件名和版本。

因为安装sqlalchemy的版本是cp312-cp312-manylinux_2_17_x86_64，目前pip不支持。

解决方案： 安装pip支持版本的安装包。

1、根据上面部分的Compatible tags支持版本，重新在下载网站中检索，下载包含第一条的版本即可：cp310-cp310-manylinux_2_17_x86_64。

2、执行命令“mv SQLAlchemy-2.0.32-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl SQLAlchemy-2.0.32-cp310-cp310-manylinux_2_17_x86_64.whl” 将文件名从 “SQLAlchemy-2.0.32-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl” 改成 “SQLAlchemy-2.0.32-cp310-cp310-manylinux_2_17_x86_64.whl”，因为要和支持版本的名称一致。

3、执行命令“pip install SQLAlchemy-2.0.32-cp310-cp310-manylinux_2_17_x86_64.whl” 。

安装成功。

参考文章：
https://blog.csdn.net/sty945/article/details/105200436
https://blog.csdn.net/qq_16763983/article/details/118674124
https://www.cnblogs.com/yizhipanghu/p/14265663.html