如何用Cython将Python脚本编译为独立轻量EXE？

太棒了，你已经选对了路子——Cython确实是解决pyinstaller/py2exe体积臃肿问题的最优解，毕竟它能把Python代码转成接近原生C的高效代码，还能彻底摆脱Python运行时的冗余依赖。我来给你补全完整的实操步骤和进阶优化技巧，帮你把整个流程跑顺，甚至把体积压到更小：

一、基础流程快速梳理（帮你确认步骤没遗漏） #

• 先搞定依赖工具
  首先得装Cython和C编译器，Windows上推荐用MinGW-w64（比MSVC更容易实现静态链接）：

  pip install cython
  

  记得把MinGW的bin目录加到系统环境变量里，方便调用gcc。

• 准备你的Python脚本
  比如写个简单的hello.py：

  print("Hello World!")
  

• 编写Cython编译配置文件
  创建setup.py，这里要注意开启优化和静态链接选项：

  from distutils.core import setup
  from Cython.Build import cythonize
  from distutils.extension import Extension
  
  ext = Extension(
      "hello",
      sources=["hello.py"],
      extra_compile_args=["-O3"],  # 开启最高级优化，既提速又减体积
      extra_link_args=["-static"]   # 关键！静态链接所有依赖，生成独立EXE
  )
  
  setup(
      ext_modules=cythonize(ext, compiler_directives={"language_level": "3"})
  )
  

• 生成C代码并编译成EXE
  先转成C代码：

  python setup.py build_ext --inplace --compiler=mingw32
  

  这时候会生成hello.c和hello.pyd，接下来用gcc直接编译成独立EXE：

  gcc -O3 -static -s -o hello.exe hello.c -I"C:\Python311\include" -L"C:\Python311\libs" -lpython311
  

  注意替换成你自己的Python安装路径和版本号（比如python311对应Python3.11）。

二、压到极致的体积优化技巧 #

• 剥离调试符号：上面gcc命令里的-s参数就是干这个的，能砍掉几MB的调试信息，完全不影响运行；
• 用UPX无损压缩：UPX是神器，能把EXE体积再压缩一半以上，而且是无损的，运行时会自动解压：

  upx --best hello.exe
  

• 精简Cython编译选项：在compiler_directives里加上"no_gc": True（如果你的代码不需要垃圾回收，比如纯计算逻辑）、"embedsignature": False，能减少生成的C代码冗余；
• 避免动态特性：给变量加上静态类型注解（比如cdef int num = 10），Cython能生成更紧凑的C代码，进一步减小体积。

三、踩坑提醒 #

• 一定要确保C编译器和Python版本匹配，比如Python3.11就得用支持它的MinGW版本，不然会出现链接错误；
• 如果你的脚本用到第三方库，比如numpy，得把依赖的库也用Cython编译，或者确保静态链接进去，不然EXE可能运行不了；
• 有些Python高级语法（比如动态导入、元类）在Cython里编译会有问题，可能需要调整代码写法，或者保留部分Python特性（但会稍微增加体积）。

内容的提问来源于stack exchange，提问作者Mohammed B.