使用requirements.txt可实现Python项目依赖的一键安装,首先通过pip freeze > requirements.txt导出依赖,建议仅保留直接依赖并规范版本控制符如==、>=、~=,然后用户可通过pip install -r requirements.txt在虚拟环境中一键安装,推荐结合虚拟环境避免冲突,新项目也可采用pyproject.toml声明依赖以实现现代化打包方式。

使用 requirements.txt 实现一键安装依赖
在 Python 项目中,最常见也最简单的一键安装依赖方式是通过 requirements.txt 文件。这个文件列出项目所需的所有第三方包及其版本,其他人只需一条命令即可安装全部依赖。
1. 生成 requirements.txt
在开发环境中,使用 pip 导出已安装的依赖:
pip freeze > requirements.txt
这会将当前环境中所有包(包括版本号)写入文件。建议只保留项目真正用到的直接依赖,避免包含多余的包。
立即学习“Python免费学习笔记(深入)”;
2. 编写规范的 requirements.txt
一个清晰的依赖文件示例如下:
flask==2.3.3 requests>=2.28.0 numpy~=1.24.0
版本控制建议:
-
==锁定精确版本,适合生产环境 -
>=允许向上兼容更新 -
~=允许补丁级更新
3. 一键安装依赖
用户克隆项目后,运行以下命令即可自动安装所有依赖:
pip install -r requirements.txt
推荐先创建虚拟环境,避免依赖冲突:
python -m venv venv source venv/bin/activate # Linux/Mac # 或 venv\Scripts\activate # Windows pip install -r requirements.txt
4. 可选:使用 pyproject.toml(现代方式)
对于新项目,可以采用更现代的打包方式。在 pyproject.toml 中声明依赖:
[build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta"[project] dependencies = [ "flask", "requests>=2.28.0" ]
然后通过 pip install . 安装项目及其依赖。
基本上就这些。使用 requirements.txt 是最直接、广泛支持的方法,适合大多数 Python 项目快速实现一键安装依赖。










