Python项目依赖项管理的秘诀：requirements.txt文件

电玩女神 2024-03-16 18:47 17阅读 0赞

### 一、背景 ###

公司里面很多时候我们开发的Python项目都不只是我们一个人使用，而是整体团队使用。Python项目需要在别人的电脑环境中运行，则需要别人的电脑环境中也要安装上我们项目需要的python库。那么项目中到底用到了哪些Python库，每个库具体是用哪个版本，一个一个手动记载肯定是非常麻烦，而且容易遗漏，另外别人拿着我们的项目去一个一个手动安装库也很不方便。

因为为了解决以上的问题，requirements.txt应运而生，只需要一个requirements.txt文件，记录项目使用了哪些库哪个版本，别人用我们的项目的时候也可以一键安装项目所需要的所有库。

### 二、什么是 requirements.txt 文件？ ###

requirements.txt 文件是一个文本文件，用于列出你的Python项目所依赖的软件包及其版本。该文件通常位于项目的根目录中，并且由开发者手动维护。在该文件中，每行列出一个依赖项，格式为 package\_name==version，其中 package\_name 是软件包的名称，version 是软件包的版本号。例如：

requests==2.25.1
    numpy==1.19.3
    pandas==1.2.0

### 三、生成requirements.txt的两种方式 ###

**1、使用pip freeze命令**

直接使用pip freeze命令生成requirements.txt文件：

pip freeze > requirements.txt

但是这种方式只适合你的项目是使用单虚拟环境的情况，因为该方式会将环境中安装的所有依赖库都记录在requirements.txt文件中，即使当前项目没有用到这个库：  
![在这里插入图片描述][ca2f3394d7c64aadbd57195307c80b40.png]  
如果项目是使用单虚拟环境的情况，由于单虚拟环境中只安装了本项目需要的库，因此用上面这个命令是可以的。

**2、使用pipreqs命令**

pipreqs也是一个库，先安装它：

pip install pipreqs

需要离线安装的可以在这里下载： [https://github.com/bndr/pipreqs][https_github.com_bndr_pipreqs]

然后使用下面的命令生成requirements.txt文件：

pipreqs ./ --encoding=utf8 --force

命令解释：

*  ./表示在当前目录下生成requirements.txt文件
 *  encoding=utf8 为使用utf8编码，不然可能会报UnicodeDecodeError: ‘gbk’ codec can’t decode byte 0xae in position 406: illegal multibyte sequence 的错误。
 *  force 强制执行，表示如果生成目录下的requirements.txt存在时，则覆盖生成新的。

可以看见requirements.txt文件中只有本次项目用到的依赖包了：  
![在这里插入图片描述][3f09c99d3b3840018fde5a9219b9fdaa.png]

### 四、使用requirements.txt文件 ###

别人的电脑上在Pycharm中可以依赖requirements.txt文件，一键逐个安装项目所有的依赖包。使用以下命令：

pip install -r requirements.txt

如果安装时报错：ERROR: Could not install packages due to an OSError: \[WinError 5\]：xxxx, Consider using the `--user` option or check the permissions  
![在这里插入图片描述][7d6aebebdf8c4ab5abb6b311e9050dbc.png]  
则根据错误提示，直接在命令中加入–user即可解决问题：

pip install --user -r requirements.txt

### 五、结论 ###

在本文中，我们介绍了 requirements.txt 文件的作用、格式和如何使用它来管理你的依赖项。使用 requirements.txt 文件，可以确保你的项目在不同的开发环境中运行一致，并且可以简化项目的部署和维护。希望这篇文章对你有所帮助，并且可以更好地管理你的 Python 项目。

=================================================================================================  
以上就是本次的全部内容，如果对你有帮助，麻烦点个赞+收藏+关注，一键三连啦~

欢迎关注下方我的公众号：**程序员杨叔**，各类文章、框架Demo源码都会在上面发布，持续分享各类测试开发知识干货，你的支持就是作者更新最大的动力。

[ca2f3394d7c64aadbd57195307c80b40.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/5d620e0915314a1b8ac0b72a705aaa6a.png
[https_github.com_bndr_pipreqs]: https://github.com/bndr/pipreqs
[3f09c99d3b3840018fde5a9219b9fdaa.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/81555a4265c648aab733a17b3cf58769.png
[7d6aebebdf8c4ab5abb6b311e9050dbc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/4cbd3cc02ca84262bd1a7a9d2d4d2542.png