Python 依赖管理：pipreqs vs freeze，谁才是王者？ 原创

大家好，我是程序员晚枫。今天来聊聊 Python 项目依赖管理的那些事儿。

如果你的Python项目依赖库多得像天上的星星，那管理起来可真是让人头大。今天，我就来分享一下我维护自己的开源项目python-office依赖库的经验，顺便给大家推荐一个超好用的工具：pipreqs。

依赖管理的痛点

在 python-office 开源开发中，依赖库管理一直是个让人头疼的问题。项目依赖库一多，环境不一致、版本冲突、安装失败等问题就接踵而至。尤其是在团队协作时，大家的开发环境各不相同，经常会出现“在我机器上没问题，但到你那儿就炸了”的情况。

为了解决这个问题，Python 社区提供了很多工具，比如 pip freeze 和 pipreqs。今天，我们就来比较一下这两个工具，看看谁才是真正的王者。

pip freeze：简单粗暴，但不够精准

pip freeze 是最常用的工具之一。它会列出当前环境中所有已安装的 Python 包及其版本，并生成一个 requirements.txt 文件。使用方法很简单：

pip freeze > requirements.txt
1.

看起来很美好，但问题是，它会把当前环境中的所有包都列出来，包括那些你根本没用到的库。比如，你用的是虚拟环境，pip freeze 会把虚拟环境目录下的所有依赖都写进去，导致生成的 requirements.txt 文件又大又乱。

更糟糕的是，如果你的项目中有多个虚拟环境，pip freeze 会把它们的依赖都混在一起，根本没法区分。这就好比在一个乱七八糟的房间里找东西，费时费力。

pipreqs：精准分析，干净利落

相比 pip freeze，pipreqs 是一个更智能的工具。它会分析你的项目代码，只列出项目中实际使用的依赖库，生成一个干净的 requirements.txt 文件。使用方法也很简单：

pip install pipreqs
pipreqs .
1.
2.

pipreqs 的优势在于，它不会把虚拟环境目录中的依赖写进去，只会列出项目中真正用到的库。生成的 requirements.txt 文件简洁明了，非常适合团队协作。

重点：用 pipreqs 忽略虚拟环境

虽然 pipreqs 默认会忽略虚拟环境目录，但有时候你可能需要更灵活地控制忽略的目录。比如，你的项目中可能有多个虚拟环境目录，或者你希望忽略一些特定的文件夹。

pipreqs 提供了 --ignore 参数，可以轻松忽略指定的目录或文件。例如：

pipreqs . --ignore venv
1.

这条命令会忽略 venv 目录，只分析项目中其他文件的依赖。

如果你需要忽略多个目录，可以用逗号分隔：

pipreqs . --ignore venv,other_dir
1.

或者：

pipreqs . --ignore venv --ignore other_dir
1.

pipreqs 还支持通配符，比如忽略所有以 venv 开头的目录：

pipreqs . --ignore venv*
1.

总结与讨论

总的来说，pipreqs 是一个比 pip freeze 更精准、更高效的工具，特别适合依赖库多的项目。它能帮你生成干净的 requirements.txt 文件，避免虚拟环境的干扰。

不过，工具只是手段，关键还是看你怎么用。如果你有更好的依赖管理方法，或者对 pipreqs 有其他使用技巧，欢迎在评论区分享！让我们一起讨论，找到最适合自己的解决方案。

大家觉得呢？你更喜欢用 pipreqs 还是 pip freeze？有没有遇到过依赖管理的坑？快来聊聊吧！