Python依赖包一键导出与批量安装：freeze、pipreqs及离线部署实践

脚本专家

当我们在新的Windows 11（或其他系统）环境中部署Python项目时，往往会发现缺少大量依赖包。一个个手动安装不仅费时，还容易遗漏版本依赖。本文将介绍如何通过pip内置命令和第三方工具pipreqs，一键导出项目依赖列表，并实现在线或离线批量安装，提高部署效率。

2. # 方法一：pip freeze（适用于纯净环境）
3. pip freeze > ./requirements.txt

复制代码

2. # 方法二：pipreqs（适用于复杂环境，仅抽取项目实际使用的依赖）
3. pip install pipreqs
4. pipreqs ./ --encoding=utf8

复制代码

导出依赖后，可使用以下命令一键安装：

2. # 在线安装（需网络）
3. pip install -r ./requirements.txt

复制代码

若目标环境无网络，可采用离线方式：

2. # 第一步：在当前有网络的环境下载离线包
3. pip wheel -w python_package_tmp_dir -r .\requirements.txt
4. # 或使用 pip download（详见下文区别）
5. pip download -d python_package_tmp_dir -r requirements.txt
7. # 第二步：在离线环境安装
8. pip install --no-index --find-links=python_package_tmp_dir -r requirements.txt

复制代码

关于pip wheel和pip download的区别：
pip wheel会从PyPI下载包并生成二进制wheel文件（.whl），该文件可直接用于离线安装，也可传播给其他机器，便于分发。pip download则下载包的源代码及依赖文件（包含wheel时也会同时下载），但不会主动生成wheel格式，适用于用户需要手动编译或审查源码的场景。

总结：
- 若环境干净且所有包均为项目所用，使用pip freeze快速导出。
- 若环境混杂或只关心项目实际依赖，pipreqs更为合适。
- 离线部署时，优先使用pip wheel生成wheel包，体积小且安装快；若需要源码调试，可选择pip download。

以上方法可有效解决Python项目迁移时的依赖管理问题，避免手动逐个安装的麻烦，提升开发与部署效率。

热心网友5

这篇文章写得很实用，刚好解决了Python项目迁移时最头疼的依赖问题。我平时也常用pip freeze快速导出，但确实会发现很多无关包被带进去，pipreqs能精准抽取实际依赖这个点很赞。离线部署部分，pip wheel生成whl文件的速度和稳定性确实比源码安装好很多，你提到的wheel和download区别也解释得很清楚，之前一直纠结该用哪个，现在明白了。另外提个小建议，如果在生成requirements.txt后手动检查一下版本号是否锁定，能避免不同环境下的兼容性问题。感谢分享！

热心网友2

这篇文章写得非常实用，尤其是 pip freeze 和 pipreqs 的对比很清晰，离线部署的步骤也很有参考价值。我之前在移植项目时也经常因为依赖遗漏踩坑，用 pipreqs 确实能更精准地抓到实际需要的包。一个小补充：如果项目里用了某些通过本地路径安装的包（比如 `-e .` 的开发模式），pip freeze 导出的路径在换环境后可能要手动调整一下。感谢分享！

热心网友3

感谢楼主分享这么实用的依赖管理经验！平时项目迁移确实常被依赖问题折腾，尤其是离线环境。你对比的 `pip wheel` 和 `pip download` 区别很清晰，之前我只知道用 `pip freeze`，现在试试 `pipreqs` 看能不能避免导出很多无关包。另外想请教一下，用 `pipreqs` 导出时如果遇到某些包在代码里是动态导入或者通过 `__import__` 引用的，是不是就没法检测到了？这种情况有什么好办法补充吗？