咱们先从第一个场景说起——这种方式需要目标系统有对应版本的Python运行时，适合你只是想把Python逻辑封装成C可调用的模块，不想搞太复杂的打包。步骤大概是这样：

• 先梳理你的Python库和依赖：如果是纯Python依赖，后续可以用Cython一起编译；如果是C扩展类的依赖（比如numpy），要确保编译时能找到它们的头文件和库文件。
• 写Cython封装文件（比如mylib_wrapper.pyx）：把你要暴露给C的函数用cdef public声明，或者直接定义C风格的函数，举个例子：

  cdef public int my_python_func(int a, int b):
      # 这里调用你的Python库逻辑
      from mylib import core_func
      return core_func(a, b)
  

• 编写setup.py配置编译规则，指定把Python代码转成C扩展：

  from setuptools import setup
  from Cython.Build import cythonize
  
  setup(
      ext_modules=cythonize([
          "mylib_wrapper.pyx",
          # 如果有纯Python依赖文件，也可以加在这里一起编译
          "mylib/core.py"
      ]),
      include_dirs=[...]  # 如果有C扩展依赖，加对应的头文件路径
  )
  

• 执行编译命令：python setup.py build_ext --inplace，会生成.so（Linux/macOS）或.pyd（Windows）的动态库，还有对应的.h头文件。
• 在C代码里调用：包含生成的头文件，链接这个动态库和Python的动态库，示例C代码：

  #include "mylib_wrapper.h"
  #include <Python.h>
  
  int main() {
      Py_Initialize();  // 初始化Python运行时
      import_mylib_wrapper();  // 导入编译好的模块
      int result = my_python_func(2, 3);
      Py_Finalize();
      return result;
  }
  

  编译C代码时要链接对应的库，比如Linux下用gcc main.c -o test -lmylib_wrapper -lpython3.10（替换成你的Python版本）。

这个场景就是你说的用--embed参数的情况，核心是把Python解释器、你的代码和所有依赖都打包成一个独立的可执行文件，目标系统啥都不用装就能跑。这里要注意几个关键点：

• 先搞到静态编译的Python解释器：如果你用系统自带的Python，大概率是动态链接的，得自己编译Python源码，编译时加./configure --enable-shared=no --enable-static=yes，生成静态库libpythonX.a（X是版本号）。
• 用Cython的--embed参数生成带入口的C代码：比如写一个main.pyx作为程序入口，调用你的库和依赖：

  from mylib import run_all_logic
  
  if __name__ == "__main__":
      run_all_logic()
  

  然后执行cython --embed main.pyx，生成main.c文件。
• 编译C代码时静态链接所有依赖：用gcc的话，命令大概是这样（要替换成你的路径和版本）：

  gcc main.c -o my_standalone_app \
      $(python-config --cflags --ldflags --embed) \
      -I/path/to/your/deps/include \
      -L/path/to/your/deps/lib \
      -lmydep1 -lmydep2  # 如果有C扩展依赖的静态库，加在这里
  

  这里的--embed参数会让python-config输出静态链接的参数，把Python解释器打包进去。
• 处理纯Python依赖：如果你的依赖是纯Python库，最好也用Cython把它们编译成C代码，一起加入编译流程，避免运行时还要找.py文件；如果是C扩展依赖，一定要用它们的静态库，不然还是会依赖动态库。
• 测试：把生成的可执行文件拷贝到没有Python的系统上运行，确认所有功能正常。

额外提醒 #

• 不是所有Python库都能完美静态嵌入，比如有些依赖系统动态库（比如OpenSSL）的库，可能还是需要目标系统有这些库，但至少不用装Python了。
• 编译时尽量用-O2优化参数，减少最终可执行文件的大小。

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