如何将多个Cython编译生成的.c模块打包为单个独立.exe可执行文件

前置准备 #

先确认你已通过cythonize命令将所有.pyx文件生成对应.c文件，同时安装好对应版本的MSVC编译器（Windows平台）、Python开发包，可选安装PyInstaller/cx_Freeze用于打包。以下提供两种成熟适配方案，可根据项目需求选择： #

方案一：Cython编译扩展模块 + PyInstaller打包（适配成本最低） #

无需改动现有Cython模块代码，适合绝大多数项目场景：

• 第一步：批量编译所有Cython模块为.pyd扩展文件
  编写setup.py配置文件，将所有.pyx文件纳入编译列表，示例如下：

  from setuptools import setup
  from Cython.Build import cythonize
  setup(
      ext_modules = cythonize(["module1.pyx", "module2.pyx", .../*剩余8个模块路径依次填入*/])
  )
  

  运行命令python setup.py build_ext --inplace，编译完成后会得到10个对应.pyd文件，保留项目的入口启动脚本（如main.py，用于调用所有Cython模块）。
• 第二步：PyInstaller单文件模式打包
  直接执行打包命令：
  pyinstaller --onefile main.py
  若为GUI程序可追加--windowed参数隐藏控制台窗口。PyInstaller会自动识别所有导入的.pyd依赖，将Python运行时、扩展模块、第三方依赖全部打包进单个EXE，最终生成的可执行文件存放在dist目录下。

  提示：如果出现隐藏导入缺失的报错，可追加--hidden-import 缺失模块名参数手动指定依赖。

方案二：全C静态编译（无Python环境依赖，体积更小） #

如果需要生成完全脱离Python环境的独立EXE，可采用纯C编译链路：

• 第一步：调整入口模块配置
  给入口.pyx文件加上__main__执行逻辑，修改setup.py将所有生成的.c文件纳入编译源，同时配置生成可执行文件而非扩展模块，示例如下：

  from setuptools import setup
  from Cython.Build import cythonize
  from distutils.core import Extension
  from cx_Freeze import Executable
  
  ext_modules = [
      Extension(
          "my_app",
          sources=["main.pyx", "module1.c", "module2.c", .../*剩余7个.c文件路径依次填入*/],
          # 有第三方静态依赖可在libraries参数中指定
      )
  ]
  setup(
      name="my_app",
      ext_modules=cythonize(ext_modules),
      executables = [Executable("main.pyx", base=None)]
  )
  

• 第二步：编译时添加静态链接参数，将MSVC运行库等依赖全部静态编译进程序，最终生成的就是无需附带任何其他文件的独立EXE。

常见问题排查 #

• 打包后运行提示缺失DLL时，可通过dumpbin /dependents 你的EXE路径命令查看依赖项，将对应DLL纳入打包列表，或改用静态编译参数解决。
• 若Cython模块间存在相互导入，编译前先在本地测试运行正常，确保所有模块路径都在sys.path中再执行打包。

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