Python项目如何生成requirements.txt文件

Pyhon项目中，一般都会有一个 requirements.txt 文件，这个文件主要是用于记录当前项目下的所有依赖包及其精确的版本号，以方便在一个新环境下更快的进行部署。

使用 pip freeze 生成

一般情况，我们可以直接使用Python下的 pip 包管理工具，来生成 requirements.txt 文件，命令如下：

pip freeze > D:\pycharm\requirements.txt

其中，D:\pycharm\requirements.txt 为生成的 requirements.txt 文件的具体路径。通过这个 pip freeze 方式生成时，会把整个Python环境下的所有包都列出生成，比较适用于Python项目为虚拟环境的情况。

使用 pipreqs 生成

我们还可以通过第三方库 pipreqs 来生成 requirements.txt 文件，这个方式有一个好处，那就是它可以只生成我们当前Python项目中所用到的依赖包及其版本号，而不是像 pip freeze 方式一样把所有包全部列出生成。

• 安装pipreqs

可以直接通过 pip 来安装 pipreqs，安装命令：

pip install pipreqs

安装后通过 pip show pipreqs 查看，我这里安装的版本是 0.4.10。

D:\>pip3 show pipreqs
Name: pipreqs
Version: 0.4.10
Summary: Pip requirements.txt generator based on imports in project
Home-page: https://github.com/bndr/pipreqs
Author: Vadim Kravcenko
Author-email: vadim.kravcenko@gmail.com
License: Apache License
Location: d:\python\installation\lib\site-packages
Requires: yarg, docopt
Required-by:

• 使用pipreqs

pipreqs 使用起来也很容易，命令使用方式为：pipreqs 当前Python项目的根目录。

D:\>pipreqs D:\pycharm\Code\flaskDemo
Traceback (most recent call last):
  File "d:\python\installation\lib\runpy.py", line 193, in _run_module_as_main
    "__main__", mod_spec)
  File "d:\python\installation\lib\runpy.py", line 85, in _run_code
    exec(code, run_globals)
  File "D:\Python\installation\Scripts\pipreqs.exe\__main__.py", line 9, in <module>
  File "d:\python\installation\lib\site-packages\pipreqs\pipreqs.py", line 470, in main
    init(args)
  File "d:\python\installation\lib\site-packages\pipreqs\pipreqs.py", line 409, in init
    follow_links=follow_links)
  File "d:\python\installation\lib\site-packages\pipreqs\pipreqs.py", line 122, in get_all_imports
    contents = f.read()
UnicodeDecodeError: 'gbk' codec can't decode byte 0x84 in position 100: illegal multibyte sequence

在执行时，可能会出现上面提示编码方式不对的情况，为解决这个问题，我们可以在执行命令中指定编码方式为 utf-8 ，如下：

D:\>pipreqs D:\pycharm\Code\flaskDemo --encoding=utf8
INFO: Successfully saved requirements file in D:\pycharm\Code\flaskDemo\requirements.txt

如果我们Python项目的根目录中已存在 requirements.txt ，那么使用上面命令就会出现警告：

D:\>pipreqs D:\pycharm\Code\flaskDemo --encoding=utf-8
WARNING: Requirements.txt already exists, use --force to overwrite it

警告信息中的提示，告诉我们可以使用参数 --force 来覆盖重新生成 requirements.txt ，如下：

pipreqs D:\pycharm\Code\flaskDemo --encoding=utf-8 --force

执行requirement.txt

生成 requirement.txt 后，我们查看其发现是这样的格式：

PyMySQL==0.9.3
Flask==1.0.3
redis==3.4.1

那么，对于 requirement.txt 中列出的第三方库，应该如何去执行并安装呢？安装方式很简单，我们通过 pip 工具，执行命令：pip install -r requirements.txt ，该命令会把 requirements.txt 文件中列出的库依次进行安装，最后等待安装完成即可。