Mac环境下借助Docker使用Py2exe打包Windows Python程序

作为Mac用户，直接在Docker中运行Windows容器会有兼容性限制（Docker Desktop for Mac仅原生支持Linux容器），所以更可行的方案是基于Linux镜像，通过Wine模拟Windows环境，再安装Python 3.6.5和py2exe来打包你的应用。下面是详细步骤：

第一步：编写Dockerfile #

创建一个名为Dockerfile的文件，内容如下：

# 基于Ubuntu 18.04（兼容Python 3.6.5和旧版Wine）
FROM ubuntu:18.04

# 设置环境变量避免交互提示
ENV DEBIAN_FRONTEND=noninteractive

# 更新系统并安装Wine及依赖工具
RUN apt-get update && apt-get install -y \
    wine \
    winetricks \
    wget \
    unzip \
    && rm -rf /var/lib/apt/lists/*

# 配置Wine为Windows 10环境
RUN winetricks win10

# 下载Python 3.6.5 Windows安装包（64位版本，需32位可替换为对应链接）
RUN wget -O python-installer.exe https://www.python.org/ftp/python/3.6.5/python-3.6.5-amd64.exe

# 静默安装Python到Wine环境
RUN wine python-installer.exe /quiet InstallAllUsers=1 PrependPath=1

# 验证Python安装（可选，用于调试）
RUN wine python --version

# 安装py2exe和你的应用依赖
COPY requirements.txt /app/requirements.txt
WORKDIR /app

# 通过pip安装依赖（用wine调用Windows环境的pip）
RUN wine pip install -r requirements.txt
RUN wine pip install py2exe==0.10.4.0  # 对应Python3.6的稳定兼容版本

# 复制你的Python应用代码到容器中
COPY . /app

# 设置默认命令进入交互shell
CMD ["bash"]

第二步：准备你的应用文件 #

确保项目目录结构如下：

your-project/
├── Dockerfile
├── requirements.txt  # 包含应用所有依赖，比如requests、numpy等
└── your-app.py      # 你的主Python应用文件

如果没有requirements.txt，可以在本地Python3.6.5环境中运行pip freeze > requirements.txt生成，注意要匹配版本避免冲突。

第三步：构建Docker镜像 #

在项目目录下打开终端，运行以下命令构建镜像：

docker build -t py2exe-windows .

第四步：运行容器并执行打包 #

构建完成后，运行容器并挂载本地目录同步打包结果：

docker run -it -v $(pwd)/dist:/app/dist py2exe-windows

这里-v $(pwd)/dist:/app/dist会把本地的dist目录和容器内的对应目录绑定，打包好的exe文件会直接同步到你的Mac本地。

进入容器后，先创建py2exe的配置文件setup.py，示例内容：

from distutils.core import setup
import py2exe

setup(
    console=['your-app.py'],  # 若为GUI应用，替换为windows=['your-app.py']
    options={
        'py2exe': {
            'bundle_files': 1,  # 打包成单个exe文件
            'compressed': True,
            'includes': []  # 若打包时缺模块，在这里添加，比如['requests']
        }
    },
    zipfile=None,
)

最后执行打包命令：

wine python setup.py py2exe

完成后，你Mac本地的dist目录里就会生成可用的Windows可执行文件了。

常见问题排查 #

• 若Python安装失败：尝试切换为32位Python安装包，部分Wine环境对64位程序支持有限。
• 若依赖安装报错：检查requirements.txt中的包版本是否兼容Python3.6.5，部分新包已不再支持该版本，需指定旧版。
• 若打包缺失模块：在setup.py的includes参数中手动添加需要打包的模块。

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