Cython编译带参数Python文件失败：段错误与链接问题求助

已执行步骤 #

• 运行以下Python代码生成C文件：

import distutils.core
import Cython.Build
distutils.core.setup( ext_modules = Cython.Build.cythonize("main_file_that_accepts_sysv_args.py"))
distutils.core.setup( ext_modules = Cython.Build.cythonize("helper_file.py"))

运行后成功生成.c后缀文件。

• 执行gcc命令编译主文件：

gcc -shared -pthread -fPIC -fwrapv -O2 -Wall -fno-strict-aliasing -Ipython/anaconda3/include/python3.9 -o main main_file_that_accepts_sysv_args.c

运行生成的main时，即使传入正确参数也出现段错误。实际需要优化的是helper_file.py（已生成对应.c文件），不确定是否要将它加入gcc编译列表，也不清楚段错误原因及是否需要修改C代码，使用Python 3.9，求问遗漏了哪些步骤？

后续尝试（编辑补充） #

尝试分开编译成动态库再链接：

gcc -shared -pthread -fPIC -fwrapv -O2 -Wall -fno-strict-aliasing -Ipython/anaconda3/include/python3.9 -o main.so main_file_that_accepts_sysv_args.c
gcc -shared -pthread -fPIC -fwrapv -O2 -Wall -fno-strict-aliasing -Ipython/anaconda3/include/python3.9 -o helper.so helper_file.c
gcc -o main main.so helper.so

但链接器出现大量未定义引用错误，猜测需要链接Cython相关库，但不清楚库的位置，细节模糊。

解决思路 #

1. 用setuptools自动完成编译（推荐） #

不要手动用gcc编译，直接通过setup.py统一处理两个文件，避免手动编译的链接问题：

from setuptools import setup
from Cython.Build import cythonize

setup(
    ext_modules = cythonize(["main_file_that_accepts_sysv_args.py", "helper_file.py"])
)

运行python setup.py build_ext --inplace，会自动生成正确链接的.so（Linux/macOS）或.pyd（Windows）文件，这些文件可直接被Python导入使用。

2. 段错误与链接错误的核心原因 #

• 手动编译时未链接Python运行时库：Cython生成的C代码依赖Python解释器API，直接编译成可执行文件会缺少必要依赖，导致运行时崩溃。正确做法是编译成Python扩展模块，由Python解释器加载运行，而非独立可执行文件。
• 若要生成独立可执行文件，需嵌入Python解释器：
  1. 先执行cython --embed main_file_that_accepts_sysv_args.py，生成带嵌入解释器的C文件
  2. 编译时链接Python库（替换路径为你的Anaconda实际路径）：

     gcc -pthread -fPIC -fwrapv -O2 -Wall -fno-strict-aliasing -Ipython/anaconda3/include/python3.9 -Lpython/anaconda3/lib -lpython3.9 -o main main_file_that_accepts_sysv_args.c helper_file.c
     

     需将helper_file.c加入编译列表，因为主文件依赖它。

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