如何在Python项目中预置依赖库？离线/代理受限场景解决方案问询

方案1：打包完整虚拟环境 #

• 操作步骤：
  1. 本地创建虚拟环境：python -m venv project_env
  2. 激活虚拟环境并安装所有依赖：pip install -r requirements.txt
  3. 将整个project_env目录和你的项目代码、requirements.txt一起压缩打包
• 接收方使用方式：
  1. 解压后激活该虚拟环境（Windows：project_env\Scripts\activate；Mac/Linux：source project_env/bin/activate）
  2. 直接运行项目代码即可
• 注意：需保证你的本地环境与接收方的操作系统、Python主版本一致，否则可能出现兼容性问题。如果要适配多环境，需分别打包对应环境的虚拟环境。

方案2：打包成独立可执行文件 #

• 工具选择：PyInstaller、cx_Freeze等，其中PyInstaller最常用
• 操作步骤：
  1. 本地安装PyInstaller：pip install pyinstaller
  2. 进入项目根目录，执行打包命令：pyinstaller --onefile your_main_script.py（--onefile会把所有内容打包成单个文件）
  3. 打包完成后，dist目录下的可执行文件就是成品
• 接收方使用方式：无需安装Python，直接双击可执行文件运行
• 注意：需针对目标操作系统分别打包（比如Windows下打包的.exe无法在Mac上运行），打包时尽量在与接收方一致的系统环境下操作。

方案3：预下载全量本地依赖包（改进你的whl方案） #

• 解决单一whl兼容性问题：通过pip download下载所有依赖的源码包（sdist）+ 多平台兼容whl，让接收方的pip自动选择适配环境的包
• 操作步骤：
  1. 本地执行命令下载依赖到指定目录：pip download -d ./local_deps -r requirements.txt（如果要强制下载源码包，可加--no-binary :all:）
  2. 将local_deps目录、requirements.txt和项目代码一起分享
• 接收方使用方式：执行pip install --no-index --find-links=./local_deps -r requirements.txt，全程无需联网，pip会自动从本地目录选择合适的包安装

方案选择建议 #

• 如果希望接收方完全不用接触Python环境，选方案2
• 如果需要保留Python环境的灵活性（比如接收方可能要修改代码），选方案1或方案3，其中方案3对环境兼容性的适配性更好

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