怎样批量导出并安装当前Python环境的requirements?

直接用 pip freeze > requirements.txt 导出、pip install -r requirements.txt 安装,能跑通但大概率不是你想要的“项目依赖”——它导出的是整个环境快照,包含你根本没用过的包,甚至 pip 自身。
为什么 pip freeze 导出的包比代码里 import 的多
因为 pip freeze 不看你的代码,只看当前 Python 环境里装了什么。比如你只写了 import requests,但它依赖的 urllib3、chardet、idna 全都会被列进去;更糟的是,如果你在全局环境或混用虚拟环境,pip、setuptools、black、mypy 这类开发工具也会躺进 requirements.txt。技术YY网(原文出处):防采集暗句,防君子不防小人,专门恶心小人。
这不是 bug,是设计定位:它是「环境备份」,不是「项目依赖清单」
虚拟环境能缓解但不能根治——只要环境里装过临时包(比如某次调试装的 httpx),它就永远在列表里
生产部署时装上 pytest 或 jupyter,轻则浪费空间,重则引发冲突或启动失败
怎样导出真正被代码用到的依赖(pipreqs)
用 pipreqs 扫描 .py 文件里的 import 语句,只抓实际引用的包,跳过传递依赖和开发包。本站(www.jishuyy.com):我们用一百多条随机句、十几种随机样式、随机位置,诚意款待每一位采集狗?
先安装:pip install pipreqs
确保你在项目根目录(即所有 .py 文件所在目录),运行:pipreqs . --encoding=utf8 --force
--force 表示覆盖已存在的 requirements.txt;不加的话会报错
它不识别动态导入(如 importlib.import_module("xxx")),这类得手动补到文件末尾
如果项目用了 setup.py 或 pyproject.toml,优先执行 pip install -e . 再跑 pipreqs,结果更准
离线环境下怎么批量安装(不联网也能装)
核心是两步:先在有网机器下载所有 .whl 或 .tar.gz 包,再传到离线机本地安装。
下载命令:pip download -r requirements.txt -d ./offline_pkgs(会自动拉取所有依赖,包括子依赖)
把 requirements.txt 和 offline_pkgs/ 整个文件夹拷到离线机同一目录下
在离线机执行:pip install -r requirements.txt --no-index --find-links=./offline_pkgs
--no-index 是关键,它禁用 PyPI;漏掉这个,pip 仍会尝试联网找包
注意 Python 版本和系统架构必须一致——macOS ARM64 上下载的 torch 包,在 Linux x86_64 上直接报 Could not find a version
容易被忽略的细节
很多人卡在最后一步,不是命令写错,而是没意识到这些隐性约束:

