【Python】使用 pip freeze 的完整指南

---

这是我父亲 日记里的文字
这是他的生命 留下留下来的散文诗
几十年后 我看着泪流不止
可我的父亲已经 老得像一个影子
                     🎵 许飞《父亲写的散文诗》

---

pip freeze 是 Python 包管理器 pip 的一个非常有用的命令，它可以列出当前 Python 环境中已经安装的所有包及其版本。这在创建一个稳定的、可重复的开发环境或共享项目依赖时非常有用。本文将详细介绍 pip freeze 的用途及其在不同场景下的使用方法。

1. 什么是 pip freeze？

pip freeze 命令会生成当前 Python 环境中所有安装包的列表，每个包都附带其版本号。这些信息通常会以一种特定的格式输出，可以直接写入文件或传递给其他工具使用。

基本用法

在命令行中运行以下命令即可列出所有已安装的包：

pip freeze

输出示例如下：

certifi==2023.7.22
chardet==4.0.0
idna==2.10
requests==2.24.0
urllib3==1.25.10

每行显示了包名和版本号，格式为 包名==版本号。

2. 创建 requirements.txt 文件

在开发 Python 项目时，我们通常需要记录所有依赖包及其版本，以便其他开发者可以在相同的环境中运行代码。pip freeze 命令可以将当前环境中的包列表保存到一个文件中，通常这个文件被命名为 requirements.txt。

生成 requirements.txt

使用以下命令生成 requirements.txt 文件：

pip freeze > requirements.txt

这将在当前目录下创建一个 requirements.txt 文件，内容类似于：

certifi==2023.7.22
chardet==4.0.0
idna==2.10
requests==2.24.0
urllib3==1.25.10

使用 requirements.txt 安装依赖
当其他开发者获取到项目代码时，可以使用 requirements.txt 文件安装所有依赖包：

```bash
pip install -r requirements.txt

这将确保安装的包版本与生成 requirements.txt 时的版本一致，确保环境的可重复性。

3. 常见用法

排除特定包

有时，你可能不希望将某些包包含在 pip freeze 的输出中。可以使用以下命令排除特定包：

pip freeze | grep -v "包名"

例如，排除 requests 包：

pip freeze | grep -v "requests"

输出到自定义文件

除了 requirements.txt，你还可以将包列表输出到任意自定义文件：

pip freeze > custom_requirements.txt

比较环境差异

如果你需要比较两个环境之间的差异，可以使用 pip freeze 生成两个环境的包列表，并使用 diff 工具进行比较：

pip freeze > env1.txt

# 切换到另一个环境
pip freeze > env2.txt
diff env1.txt env2.txt

4. 注意事项

• 虚拟环境：在使用 pip freeze 之前，确保你在虚拟环境中运行它，以避免列出全局环境中的包。
• 依赖管理：pip freeze 生成的列表是所有安装的包及其版本，但这些包可能是直接依赖或间接依赖。因此，推荐结合 pip-tools 等工具进行更细致的依赖管理。

5. 进阶使用

结合 pip-tools 使用

pip-tools 是一个用于依赖管理的强大工具，它提供了 pip-compile 命令，可以根据 requirements.in 文件生成一个 requirements.txt 文件，并且只包含直接依赖包。这个工具可以和 pip freeze 结合使用，简化依赖管理。

自动化脚本

可以编写脚本自动化处理 pip freeze 的输出，例如定期生成 requirements.txt 文件并推送到代码仓库。

import os
from datetime import datetime

def freeze_requirements():
    timestamp = datetime.now().strftime("%Y%m%d%H%M%S")
    filename = f"requirements_{timestamp}.txt"
    os.system(f"pip freeze > {filename}")
    print(f"Requirements saved to {filename}")

if __name__ == "__main__":
    freeze_requirements()

结论

pip freeze 是管理 Python 包和环境的一个基本但强大的工具。通过正确使用它，你可以轻松地创建和维护一致的开发环境，确保项目的可重复性和稳定性。无论是生成 requirements.txt 文件还是比较环境差异，pip freeze 都是你不可或缺的好帮手。