Python项目应使用pip install -r requirements.txt批量安装依赖;可用pip freeze > requirements.txt导出全部包,或pipreqs . --force仅导出代码中import的包;推荐后者用于新项目,前者用于部署;可指定镜像源加速安装,并建议生产环境分层管理依赖。

在Python项目中,用 requirements.txt 批量安装依赖是最标准、最可靠的方式,核心命令就是 pip install -r requirements.txt。
生成 Requirements 文件
如果你还没有 requirements.txt,可以用 pip 自动导出当前环境的包列表:
-
pip freeze > requirements.txt:导出所有已安装包(含子依赖),适合快速备份环境 -
pipreqs . --force:只扫描项目代码中import的包(需先pip install pipreqs),更贴近实际依赖,不含无关包
推荐后者用于新项目,前者多用于部署或复现完整环境。
安装 Requirements 中的依赖
确保你在项目根目录下(即 requirements.txt 所在位置),然后运行:
立即学习“Python免费学习笔记(深入)”;
-
pip install -r requirements.txt:安装全部依赖 -
pip install --no-deps -r requirements.txt:只装主依赖,跳过子依赖(极少用,调试时可能需要) -
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/:指定国内镜像源,加速安装
处理常见问题
安装失败或版本冲突很常见,注意以下几点:
- 版本号写法影响兼容性:
requests==2.31.0锁死版本;requests>=2.28.0允许升级;requests不限定,取最新兼容版 - 如果提示
ERROR: Could not find a version that satisfies...,可能是某包在 PyPI 已下架,或版本号拼写错误,可手动删掉该行再试 - Windows 上遇到编译错误(如
lxml、psycopg2),可改用预编译轮子:pip install --only-binary=all -r requirements.txt
进阶建议
生产项目建议分层管理依赖:
-
requirements/base.txt:基础依赖(如django、requests) -
requirements/dev.txt:开发专用(如pytest、black),开头加-r base.txt继承基础 - 安装时按需执行:
pip install -r requirements/dev.txt
这样既清晰又避免环境污染。


















