在 Python 项目中，通常会使用requirements.txt文件来记录项目依赖的所有第三方包及其版本信息。以下是几种常用的方法来生成或更新这个文件：
方法一：使用pip freeze命令
这是最常见的方法，会生成当前环境中所有已安装包的列表（包括可能与项目无关的包）。
pip freeze > requirements.txt |
特点：
- 简单直接，但可能包含不需要的包（如系统全局安装的包）。
- 记录的版本号是精确的当前安装版本。
方法二：使用pipreqs工具（推荐）
pipreqs会自动分析项目代码，只生成实际使用到的包的列表。
步骤：
- 安装pipreqs：
pip install pipreqs |
- 生成requirements.txt：
pipreqs /path/to/your/project |
-
- 如果在项目根目录下执行，可省略路径：
pipreqs . |
特点：
- 只包含项目实际导入和使用的包，更精确。
- 会自动检测包的版本。
- 生成的文件不包含版本号时，可添加--force参数覆盖。
方法三：手动编写requirements.txt
适合项目依赖明确且较少的情况，直接在文件中列出包名和版本（可选）：
# requirements.txt flask==2.3.2 requests>=2.28.0 numpy |
版本约束语法：
- ==：精确版本（如flask==2.3.2）。
- >=：最小版本（如requests>=2.28.0）。
- <=：最大版本。
- ~=：兼容版本（如numpy~=1.24.0表示>=1.24.0, <1.25.0）。
方法四：结合虚拟环境（最佳实践）
为避免包含无关包，建议在虚拟环境中操作：
- 创建并激活虚拟环境：
# 创建 python -m venv myenv # 激活（Windows） myenv\Scripts\activate # 激活（Linux/macOS） source myenv/bin/activate |
- 安装项目依赖：
pip install flask requests numpy |
- 生成requirements.txt：
pip freeze > requirements.txt |
使用建议
- 更新依赖后重新生成：每次安装或卸载包后，都应重新生成requirements.txt。
- 避免固定版本：除非必要，尽量使用>=或~=指定兼容范围，提高项目的可移植性。
- 忽略系统包：若使用pip freeze，可通过以下方式排除系统级包：
pip list --local | grep -v '^\-e' | cut -d = -f 1 | xargs -n1 pip freeze | grep -v '^\-e' > requirements.txt |
验证requirements.txt
在新环境中测试依赖是否正确：
# 创建新虚拟环境并激活 python -m venv testenv source testenv/bin/activate # 或 testenv\Scripts\activate # 安装依赖 pip install -r requirements.txt |
通过以上方法，你可以有效地管理项目的依赖关系，确保环境一致性。