requirements.txt用于记录Python项目依赖，通过pip freeze > requirements.txt生成，使用pip install -r requirements.txt还原环境，建议在虚拟环境中操作并提交版本控制，生产环境应锁定具体版本以确保稳定性。

在 Python 项目开发中，requirements.txt 是一个非常重要的文件，它记录了项目所依赖的第三方库及其版本。通过这个文件，我们可以快速还原项目的运行环境，避免“在我机器上能跑”的问题。

什么是 requirements.txt

requirements.txt 是一个纯文本文件，每行写一个 Python 包及其版本号，格式如下：

requests==2.28.1
numpy>=1.21.0
flask

其中可以指定精确版本（==）、最小版本（>=）或不指定版本（只写包名）。

生成 requirements.txt

如果你正在一个已激活的虚拟环境中开发，可以使用 pip 自动生成当前环境的依赖列表：

• pip freeze > requirements.txt

这会把当前环境中所有通过 pip 安装的包及其版本导出到 requirements.txt 文件中。建议在项目根目录下执行此命令，便于后续共享和部署。

Convert Github Repository

适用于以下场景：（1）用户提供 GitHub 仓库 URL 或本地仓库路径，并请求将其转换为其他格式；（2）用户请求导出 GitHub 仓库……

下载

使用 requirements.txt 还原环境

当别人拿到你的项目或你在新设备上部署时，只需几步即可还原环境：

• 创建并激活虚拟环境（推荐使用 venv 或 conda）
• 运行命令：pip install -r requirements.txt

pip 会自动读取文件中的每个依赖，并安装对应版本。如果某个包已安装且版本匹配，pip 会跳过；若版本冲突，会提示错误或自动升级/降级。

一些实用建议

为了确保环境还原的稳定性和可维护性，注意以下几点：

• 始终在虚拟环境中操作，避免污染全局 Python 环境
• 提交代码时，将 requirements.txt 一并上传到版本控制（如 Git）
• 定期更新 requirements.txt，尤其是在添加或升级依赖后
• 对于生产环境，建议锁定具体版本（使用 ==），避免意外更新导致兼容问题
• 可使用 pip install -r requirements.txt --no-deps 忽略子依赖（慎用）

基本上就这些。只要有了准确的 requirements.txt，还原 Python 项目环境就是一条命令的事，简单高效。