py2exe打包含xmlschema的Python脚本遇WinError3及模块缺失问题

核心原因 #

1. XSD文件找不到：xmlschema库依赖自带的XSD schema定义文件，py2exe默认仅打包Python代码文件（.py/.pyc），不会将这些非代码资源文件纳入library.zip，导致运行时程序在错误路径下寻找资源失败。
2. 模块缺失：py2exe的自动模块扫描机制无法识别xmlschema的部分间接依赖或动态导入的模块，因此打包时会提示大量模块缺失。

解决步骤 #

1. 打包XSD资源文件 #

方法一：手动复制

找到你Python环境中xmlschema的安装目录（比如Lib/site-packages/xmlschema），将其中的schemas文件夹完整复制到打包生成的dist目录下，保持结构为dist/xmlschema/schemas/（与library.zip同层级）。

方法二：通过setup.py自动打包

修改你的setup.py，添加data_files配置，让py2exe自动收集并打包这些资源：

from distutils.core import setup
import py2exe
import xmlschema
import os

# 获取xmlschema的schemas目录路径
schema_root = os.path.join(os.path.dirname(xmlschema.__file__), "schemas")
schema_files = []

# 遍历schemas目录下所有文件，整理成data_files要求的格式
for root, _, files in os.walk(schema_root):
    for file in files:
        src_path = os.path.join(root, file)
        # 计算相对路径，保证打包后目录结构一致
        dest_dir = os.path.relpath(root, os.path.dirname(xmlschema.__file__))
        schema_files.append((f"xmlschema/{dest_dir}", [src_path]))

setup(
    console=["your_script.py"],  # 替换为你的脚本文件名
    options={
        "py2exe": {
            "bundle_files": 3,
            "compressed": True
        }
    },
    data_files=schema_files
)

2. 解决模块缺失问题 #

在setup.py的py2exe选项中，手动指定需要包含的缺失模块：

setup(
    console=["your_script.py"],
    options={
        "py2exe": {
            "includes": ["lxml", "xml.etree.ElementTree", "xml.parsers.expat", ...],  # 替换为打包时提示的缺失模块
            "packages": ["xmlschema"],  # 强制包含整个xmlschema包
            "bundle_files": 3,
            "compressed": True
        }
    },
    data_files=schema_files
)

• 如果缺失模块数量较多，优先使用packages选项直接包含整个xmlschema包，减少手动添加的工作量。
• 对于标准库中的缺失模块，比如xml相关子模块，直接添加到includes列表即可。

3. 验证修复效果 #

重新执行python setup.py py2exe完成打包，运行dist目录下的xml_validator.exe，检查是否仍有错误。若资源文件问题仍存在，确认schemas目录是否位于dist/xmlschema/路径下。

内容的提问来源于stack exchange，提问作者Frederikke Kappelhøj