使用 pip freeze ＞ requirements.txt：Python 项目依赖管理的利器

---

在 Python 项目开发中，依赖管理是一个不可忽视的环节。我们经常会使用各种第三方库来加速开发流程，例如 Flask、Requests、Pandas 等。但随着项目复杂度的提升，如何准确记录并复现这些依赖环境，就成了必须解决的问题。

这时候，命令：

```bash
pip freeze > requirements.txt

就显得尤为重要。

---

一、这条命令到底做了什么？

pip freeze 会列出当前 Python 虚拟环境中安装的所有库及其确切版本号，例如：

flask==2.3.2
requests==2.31.0
pandas==2.1.0

将其导出到 requirements.txt 文件后，就能清晰记录当前的项目依赖版本。

---

二、什么场景下需要用到它？

1. 项目部署上线前

在项目部署到服务器、云平台或其他环境前，保存一个完整的依赖清单是基础步骤之一，确保生产环境和开发环境一致。

2. 多人协作开发

团队成员只需执行：

pip install -r requirements.txt

即可一键安装项目所需依赖，避免“环境不一致导致代码跑不起来”的烦恼。

3. 备份依赖，长期维护

如果你打算半年后重新维护某个项目，requirements.txt 会成为你的“时光机”，还原当时环境。

4. 部署到 Docker / CI/CD 流程

在 Dockerfile 或自动化部署中，经常会用到：

COPY requirements.txt .
RUN pip install -r requirements.txt

确保环境快速一致地搭建。

---

三、带来的好处

✅ 可移植性：让项目随时可在新环境中重现。
✅ 可维护性：长期维护代码时不会忘了用过哪些库。
✅ 自动化支持：利于自动化测试、CI/CD 构建流程集成。
✅ 防止版本不兼容：指定了确切版本，减少升级后不兼容的风险。

---

四、小技巧与补充

• 只记录直接依赖？
  pip freeze 会记录所有依赖（包括间接依赖）。如果你只想记录自己手动安装的包，推荐使用 pipreqs 工具，它能根据代码自动识别使用到的库。

• 常用命令搭配

python -m venv venv         # 创建虚拟环境
source venv/bin/activate    # 启动虚拟环境（Windows 用 venv\Scripts\activate）
pip install flask requests  # 安装所需库
pip freeze > requirements.txt

---

结语

pip freeze > requirements.txt 是一个小而强的命令，帮助我们解决环境一致性、依赖复现、团队协作等问题。它是每一个 Python 工程师都应该掌握的基本技能。

下次写完一个项目时，别忘了加上一句：

pip freeze > requirements.txt