pip download 是唯一可靠的方式——它不碰当前环境,只拉取包文件到本地;支持指定目录、二进制/源码包选择、跨平台适配,并需注意离线安装时依赖完整性、路径配置及镜像源设置。

pip download 是唯一可靠的方式——它不碰当前环境,只拉取包文件到本地。
直接下载单个包到当前目录
运行 pip download requests,会在当前目录生成 requests-2.31.0-py3-none-any.whl(或 .tar.gz)这类文件。注意:
- 不会安装任何东西,也不会修改
site-packages - 默认会递归下载所有依赖(比如
urllib3、certifi等),全部落在同一目录 - 如果网络受限,可加
-i https://pypi.tuna.tsinghua.edu.cn/simple换国内源
指定下载目录并控制包类型
用 -d 或 --dest 把文件存到别处,比如:pip download requests -d ./wheels。更关键的是区分源码和二进制包:
- 加
--only-binary=:all:强制只下.whl,适合离线部署 - 加
--no-binary=:all:强制只下.tar.gz,适合需要编译或审计源码的场景 - 跨平台时必须加
--platform和--python-version,否则可能下错架构的 wheel
离线安装时常见报错原因
用 pip install --no-index --find-links=./wheels requests 离线装失败,大概率是这几个坑:
-
--find-links路径没写对,或路径里混进了非 wheel/tar.gz 文件(pip会跳过它们但不报错) - 依赖没下全:比如
requests依赖idna,但idna的 wheel 名字含py3-none-any,若目标机器是 Python 3.12,而你下的是py39版本,就装不上 - 没加
--trusted-host或镜像源参数,导致某些包在解析阶段仍尝试联网
缓存目录不是下载目录
--cache-dir D:\pip_cache 只影响 pip 内部缓存,不影响最终输出位置。它不会让你“看到源码”,也不会把文件存成可读结构——那是临时解压路径,且随命令结束自动清理。真要看源码,要么手动打开下载下来的 .tar.gz,要么把 Downloading 后面的 URL 粘贴到浏览器下载。


















