服务器网络受限，如何让pip在本地目录查找依赖包？

这个问题我之前在离线部署Python服务时也碰到过，其实pip提供了专门的参数来处理这种场景，给你几个实用的解决方案：

方法一：用--no-index配合--find-links指定本地源 #

这是最直接的方式，告诉pip不要去官方PyPI索引查找包，而是优先从指定的本地目录里找所有依赖：

pip install ./supervisor-3.3.4.tar.gz --no-index --find-links=.

• --no-index：禁止pip访问PyPI官方索引，强制只从本地查找
• --find-links=.：指定从当前目录（.）查找所有需要的依赖包（比如meld3）
  如果你的依赖包放在其他路径，把.换成对应的目录路径即可，比如--find-links=/opt/local-packages。

方法二：提前下载所有依赖的wheel包（推荐） #

wheel包是预编译的格式，安装速度更快，而且能避免离线环境下的编译问题。步骤如下：

1. 在能联网的机器上，下载supervisor及其所有依赖的wheel包到指定目录：

pip download supervisor==3.3.4 --dest ./local-packages

2. 将整个local-packages目录复制到受限服务器上
3. 在服务器上执行安装命令：

pip install supervisor==3.3.4 --no-index --find-links=./local-packages

这样pip会自动从本地wheel包中匹配并安装所有依赖，不会尝试联网。

方法三：通过requirements.txt批量安装本地包 #

如果有多个包（主包+所有依赖）都在本地，可以创建一个requirements.txt文件，列出所有包的本地路径：

./supervisor-3.3.4.tar.gz
./meld3-2.0.1.tar.gz

然后执行安装命令：

pip install -r requirements.txt --no-index

这种方式适合需要安装多个本地包的场景，管理起来更清晰。

注意事项 #

• 要确保所有递归依赖都已经下载到本地目录，不然pip会因为找不到依赖而报错
• 如果使用源代码包（tar.gz），要确保包内的setup.py或pyproject.toml正确声明了依赖信息，这样pip才能识别到需要的依赖包
• wheel包尽量下载与服务器系统、Python版本匹配的版本，避免出现兼容性问题

内容的提问来源于stack exchange，提问作者Kramer Li