如何在Cython中导入CPython的genobject.c并解决链接错误？

问题背景 #

查了相关问题和Cython官方文档，只找到导入C头文件的示例，没提到如何导入.c文件。目标是使用CPython的genobject.c文件，有两个问题：
一、如何在Cython中导入.c文件？
二、是否需要将该.c文件置于本地目录才能访问？若是，应如何获取genobject.c文件以在Cython中使用其内容？

我的代码情况：

cpy.pxd中的声明 #

cdef extern from "Python.h":
    cdef int gen_is_coroutine(object o)

src.pxd中的使用 #

if gen_is_coroutine(__value):
    do_something(__value)

编译时出现链接错误：

constmeta.obj : error LNK2001: unresolved external symbol gen_is_coroutine
build\lib.win-amd64-cpython-310\cy_src\constmeta.cp310-win_amd64.pyd : fatal error LNK1120: 1 unresolved externals
error: command 'C:\\Program Files (x86)\\Microsoft Visual Studio\\2022\\BuildTools\\VC\\Tools\\MSVC\\14.33.31629\\bin\\HostX86\\x64\\link.exe' failed with exit code 1120

问题解答 #

错误原因说明 #

gen_is_coroutine是CPython内部的静态函数（定义在genobject.c时用了static关键字），静态函数的作用域仅限于定义它的.c文件内部，不会被导出到Python系统库中，所以即使你在Cython中声明了它，链接器也找不到这个符号，导致LNK2001错误。

问题一：如何在Cython中导入.c文件？ #

Cython并不直接"导入".c文件，正确处理流程是：

1. 在.pxd文件中用cdef extern from声明.c文件里的函数、结构体等（可对应头文件，也可直接声明）
2. 在编译脚本（比如setup.py）中，把目标.c文件加入编译源文件列表，让编译器将它和你的Cython代码一起编译、链接。

但针对你的场景，即使把genobject.c加入编译，也无法调用gen_is_coroutine——静态函数的作用域限制不允许外部访问。

问题二：是否需要将该.c文件置于本地目录？如何获取？ #

如果要编译目标.c文件，确实需要把它放到本地目录，或者在编译脚本中指定完整路径。获取方式：

• 从CPython仓库下载和你当前Python版本匹配的genobject.c文件
• 若安装了Python源码包，可在本地Python源码的Objects目录下找到它

但这个方法对你的场景没用，因为静态函数的限制无法绕过。

可行替代方案 #

方案1：使用Python公开API替代 #

Python标准库inspect模块提供了公开的iscoroutine()函数，直接在Cython中调用即可：

# Cython层面导入调用
from inspect cimport iscoroutine

if iscoroutine(__value):
    do_something(__value)

或者直接调用Python层面的函数：

import inspect

if inspect.iscoroutine(__value):
    do_something(__value)

方案2：复刻静态函数的实现到自己的代码中 #

gen_is_coroutine的实现逻辑很简单，直接把逻辑搬到Cython里：

cdef extern from "Python.h":
    ctypedef struct PyGenObject:
        PyObject_HEAD
        void* gi_origin  # 不需要完整结构体，只保留用到的字段
    int PyGen_CheckExact(object o)

cdef int my_gen_is_coroutine(object o):
    # 复刻gen_is_coroutine的判断逻辑
    return PyGen_CheckExact(o) and (<PyGenObject*>o)->gi_origin != NULL

# 使用自定义的判断函数
if my_gen_is_coroutine(__value):
    do_something(__value)

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