如何在cx_Freeze 5.x中实现原create_shared_zip=False的功能？

我之前也碰到过一模一样的情况——cx_Freeze 5.x确实移除了4.x版本中可用的create_shared_zip配置选项，但我们可以通过替代配置实现相同的核心需求：让Enthought相关模块的文件不被打包进zip，而是直接以文件形式存放在输出目录中，这是Mayavi这类依赖本地资源文件的模块正常运行的关键。

具体解决方案 #

核心思路是利用cx_Freeze 5.x提供的zip_exclude_packages和zip_include_packages参数，精准控制哪些包不被打包进zip：

1. 配置打包排除列表
   在你的setup.py中，将Enthought/Mayavi相关的包添加到zip_exclude_packages中，确保它们的文件直接输出到build目录而非zip内。示例配置如下：

   import sys
   from cx_Freeze import setup, Executable
   
   # 针对Windows GUI程序设置base，非Windows环境可以忽略
   base = 'Win32GUI' if sys.platform == 'win32' else None
   
   # 定义你的可执行文件入口
   executables = [Executable('your_main_gui.py', base=base)]
   
   setup(
       name='YourMayaviApp',
       version='1.0',
       description='GUI Application with Enthought/Mayavi',
       executables=executables,
       options={
           'build_exe': {
               # 排除Enthought相关包，避免被打包进zip
               'zip_exclude_packages': ['mayavi', 'enthought', 'traits', 'tvtk', 'vtk'],
               # 其他所有包默认打包进zip（可选，cx_Freeze默认值即为'*'）
               'zip_include_packages': ['*'],
               # 如果有缺失的动态库或资源文件，手动添加到这里
               'include_files': [],
           }
       }
   )
   

2. 手动补充缺失资源（如果需要）
   有些情况下，cx_Freeze可能无法自动检测到Mayavi/VTK依赖的所有动态库或资源文件。如果运行打包后的程序出现找不到文件的错误，可以找到对应的文件路径（通常在你的Python环境的Lib/site-packages目录下），将它们添加到include_files参数中，比如：

   'include_files': [
       (r'C:\PythonEnv\Lib\site-packages\mayavi\data', 'mayavi/data'),
       # 按需添加其他需要的资源或DLL文件
   ]
   

为什么这个方案有效 #

cx_Freeze 5.x默认会将大部分Python包打包进一个zip文件以节省空间，但Enthought的部分模块（比如Mayavi的可视化组件）需要直接访问文件系统中的资源文件或动态库，无法从zip中正常加载。通过zip_exclude_packages将这些关键包排除在外，就能让程序运行时直接读取目录中的文件，和4.x版本中create_shared_zip=False的效果完全一致。

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