Windows环境开发的Python代码如何实现含依赖的跨平台可移植？

可根据生产环境的权限限制、资源情况选择以下三种适配方案：

方案1：依赖导出+离线安装（生产环境已预装对应版本Python） #

• 第一步：在Windows开发环境的项目专属虚拟环境中导出依赖清单
  执行命令：pip freeze > requirements.txt
  注意：手动删除清单中Windows平台特有的依赖（如pywin32、wmi等），避免Linux安装报错
  如果没有临时Linux机器下载依赖，可直接在Windows侧指定平台导出兼容Linux的依赖清单：pip freeze --platform manylinux_x86_64 --python-version 你的Python版本号（如3.8） --only-binary=:all: > requirements.txt
• 第二步：批量下载Linux版本的依赖包
  在和生产环境系统、Python版本完全一致的临时Linux环境中执行：pip download -r requirements.txt -d ./pkgs
  将生成的pkgs依赖文件夹、requirements.txt、项目代码一起传到生产环境
• 第三步：生产环境离线安装依赖
  进入文件所在目录后执行：pip install --no-index --find-links=./pkgs -r requirements.txt
  安装完成后直接运行项目入口代码即可。

注意：提前检查项目代码中是否有写死的Windows路径（如C:\xxx、路径分隔符\），建议统一用Python内置的pathlib或os.path模块处理路径，自动兼容双系统。

方案2：打包为独立可执行文件（生产环境不能/不想安装Python） #

用pyinstaller工具打包为单二进制文件，不需要依赖系统环境，注意不能在Windows侧直接打包Linux可用的文件，操作流程如下：

• 准备一台和生产环境系统、架构一致的临时Linux机器，安装对应版本Python、项目所有依赖、以及pyinstaller
• 将Windows开发的项目代码拷贝到该Linux机器，完成路径兼容调整
• 执行打包命令：pyinstaller -F 你的项目入口文件.py
• 打包完成后，dist目录下生成的单二进制文件可直接传到生产环境运行，不需要额外安装任何依赖

注意：如果项目用到系统级驱动（如数据库驱动、硬件交互驱动等），需要提前在打包用的Linux机器上安装好对应驱动，保证打包时能正确关联到二进制文件内。

方案3：容器化部署（生产环境支持Docker运行） #

• 项目根目录编写Dockerfile，示例内容如下（基础镜像版本和你的Python版本保持一致即可）：

FROM python:3.9-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "你的项目入口文件.py"]

• 在和生产环境同架构的机器上执行镜像构建：docker build -t 自定义项目镜像名 .
• 把构建好的镜像导出为本地文件：docker save -o 自定义项目包名.tar 自定义项目镜像名
• 传到生产环境后导入镜像：docker load -i 自定义项目包名.tar，直接启动容器即可运行，环境完全一致不会出现依赖适配问题。

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