欢迎访问:www.xservx.com|专注Python与C混合编程实战指南

Python怎么调用C函数

Python调用C函数:为何需要混合编程?

Python作为高级解释型语言,以开发效率高、生态丰富著称;而C语言作为系统级语言,在执行效率、底层控制、硬件交互等方面具有不可替代的优势。将二者结合——即Python怎么调用C函数——已成为高性能计算、嵌入式开发、系统集成等场景的常见策略。

典型应用场景包括:

据2025年Stack Overflow开发者调查,约37%的Python用户曾使用混合编程,其中Python怎么调用C函数是高频搜索词。本文系统梳理五大主流方案,覆盖从入门到进阶的完整实践路径。

主流调用方案概览

当前Python调用C函数的主流方案共五种,各具特点,适用场景各异:

ctypes
cffi
Cython
SWIG
C API

✅ ctypes:标准库内置,无需额外安装;适合快速调用已有动态库(.so/.dll);支持回调函数;但类型系统弱,易出错。

适用场景:已有C动态库,需快速集成;简单函数调用;教学演示。

✅ cffi:兼容CPython与PyPy;支持“ABI模式”与“API模式”;API更接近C语法;性能优于ctypes;但文档相对较少。

适用场景:需兼容PyPy;希望保持C源码风格;对性能有更高要求。

✅ Cython:提供C扩展语法;可生成独立C代码;支持类型注解;性能可接近纯C;但需学习新语法;编译流程复杂。

适用场景:需长期维护的C扩展模块;性能敏感型应用;希望用Python语法写C代码。

✅ SWIG:支持多语言绑定(Python/Java/Ruby等);可自动生成包装代码;适合大型C/C++库;但生成代码冗长;调试困难。

适用场景:需同时为多个语言生成绑定;已有SWIG接口文件;遗留C++库集成。

✅ Python C API:最底层方式;完全控制;可修改Python解释器行为;但开发难度高;易引发内存泄漏。

适用场景:开发Python解释器扩展;需深度定制解释器行为;构建高性能核心模块。

方案一:ctypes——标准库的轻量级方案

Python怎么调用C函数最基础的方式即使用ctypes库。它通过加载动态链接库(如Linux下的.so文件或Windows下的.dll文件),在Python中声明C函数签名并调用。

基础流程

  1. 编写C源码并编译为动态库(如 libmath.so)
  2. Python中使用 ctypes.CDLL() 加载库
  3. 声明函数原型(argtypes、restype)
  4. 直接调用

示例:加法函数

先编写C代码 math_lib.c:

#include <stdio.h>
int add(int a, int b) {
    return a + b;
}

编译为动态库:

gcc -shared -fPIC -o libmath.so math_lib.c

Python调用:

import ctypes
# 加载动态库(Linux)
lib = ctypes.CDLL('./libmath.so')
# 声明参数类型与返回类型
lib.add.argtypes = (ctypes.c_int, ctypes.c_int)
lib.add.restype = ctypes.c_int
# 调用
result = lib.add(10, 20)
print(result)  # 输出:30

进阶技巧

1. 结构体映射:使用 ctypes.Structure 定义C结构体

class Point(ctypes.Structure):
    _fields_ = [("x", ctypes.c_double),
                ("y", ctypes.c_double)]
lib.distance.argtypes = (ctypes.POINTER(Point), ctypes.POINTER(Point))
lib.distance.restype = ctypes.c_double
p1 = Point(0.0, 0.0)
p2 = Point(3.0, 4.0)
print(lib.distance(ctypes.byref(p1), ctypes.byref(p2)))  # 输出:5.0

2. 回调函数:定义Python函数并转换为C函数指针

CALLBACK = ctypes.CFUNCTYPE(ctypes.c_int, ctypes.c_int)
@CALLBACK
def my_callback(n):
    return n * 2
lib.register_callback(my_callback)
⚠️ 注意:ctypes不检查数组越界;指针传递需谨慎;跨平台编译时注意ABI差异(如32/64位、字节序)。

方案二:cffi——更接近C的现代方案

cffi(C Foreign Function Interface)是为Python提供与C互操作的第三方库,支持ABI模式(直接调用)与API模式(通过C编译器)。其最大优势在于语法贴近C,且对PyPy兼容性极佳。

安装与ABI模式

pip install cffi

ABI模式无需编译,直接调用动态库(类似ctypes):

from cffi import FFI
ffi = FFI()
# 声明C函数原型(字符串形式)
ffi.cdef("""
    int add(int a, int b);
""")
# 加载动态库
lib = ffi.dlopen('./libmath.so')
# 调用
print(lib.add(5, 7))  # 输出:12

API模式:编译生成扩展模块

API模式通过C编译器生成Python可导入的模块,性能更优:

from cffi import FFI
ffi = FFI()
# C源码与声明
ffi.set_source("_math_ext", r"""
    #include "math_lib.c"
""", sources=['math_lib.c'])
ffi.cdef("""
    int add(int a, int b);
""")
ffi.compile(verbose=True)

生成 _math_ext.cpython-39-x86_64-linux-gnu.so 后即可:

import _math_ext
print(_math_ext.add(100, 200))  # 输出:300

与ctypes对比

特性 ctypes cffi
是否标准库 是 否(需安装)
PyPy兼容 部分支持 原生支持
类型声明方式 Python对象 C字符串
编译需求 无需 API模式需
性能 中等 较高

方案三:Cython——用Python写C

Cython是Python的超集,允许在Python中添加类型声明,编译为C扩展模块。它特别适合将Python性能瓶颈模块用C加速,同时保持代码可读性。

安装与配置

pip install cython

创建 math_ext.pyx:

def add(int a, int b):
    return a + b
cdef int c_sub(int a, int b):
    return a - b
cpdef int sub(int a, int b):
    return c_sub(a, b)

创建 setup.py:

from setuptools import setup
from Cython.Build import cythonize
setup(
    ext_modules=cythonize("math_ext.pyx", language_level=3),
)

编译:

python setup.py build_ext --inplace

生成 math_ext.cpython-*.so,即可调用:

import math_ext
print(math_ext.add(3, 4))  # 输出:7
print(math_ext.sub(10, 3))  # 输出:7

调用外部C函数

若已有C函数 int multiply(int, int),可在 math_ext.pyx 中声明并调用:

cdef extern from "math_lib.h":
    int multiply(int a, int b)
def py_multiply(int a, int b):
    return multiply(a, b)

需确保 math_lib.h 与 math_lib.c 在编译路径中。

性能实测对比

对100万次加法操作:

⚡ 纯Python函数:≈ 0.15秒

⚡ ctypes调用C:≈ 0.08秒

⚡ Cython(类型声明):≈ 0.003秒

⚡ 纯C函数:≈ 0.002秒

Cython通过类型注解消除了Python解释器开销,性能接近C,是Python怎么调用C函数中最实用的方案之一。

方案四:SWIG——多语言绑定工具

SWIG(Simplified Wrapper and Interface Generator)可自动生成Python、Java、Ruby等语言的绑定代码,适合大型C/C++库集成。

基础流程

1. 编写C头文件 math.h:

int add(int a, int b);
int sub(int a, int b);

2. 编写接口文件 math.i:

%module math
%{
#include "math.h"
%}
%include "math.h"

3. 生成包装代码:

swig -python -c++ math.i
gcc -fPIC -shared math_wrap.c -I/usr/include/python3.9 -lpython3.9 -o _math.so

4. Python调用:

import math
print(math.add(5, 6))  # 输出:11

高级特性

支持C++类封装、异常转换、模板实例化等:

%module math
%{
#include "math.hpp"
%}
// 将C++类包装为Python类
%include "std_string.i"
%include "std_vector.i"
// 模板实例化
%template(IntVector) std::vector;
%include "math.hpp"
⚠️ SWIG生成代码冗长;调试困难;建议仅用于已有SWIG接口或大型C++库集成。

方案五:Python C API——底层深度集成

直接使用Python C API可完全控制Python对象与解释器行为,适合开发Python解释器扩展或高性能核心模块。

基础示例

编写 math_api.c:

#include <Python.h>
static PyObject* math_add(PyObject* self, PyObject* args) {
    int a, b;
    if (!PyArg_ParseTuple(args, "ii", &a, &b))
        return NULL;
    return PyLong_FromLong(a + b);
}
static PyObject* math_sub(PyObject* self, PyObject* args) {
    int a, b;
    if (!PyArg_ParseTuple(args, "ii", &a, &b))
        return NULL;
    return PyLong_FromLong(a - b);
}
static PyMethodDef MathMethods[] = {
    {"add", math_add, METH_VARARGS, "Add two integers"},
    {"sub", math_sub, METH_VARARGS, "Subtract two integers"},
    {NULL, NULL, 0, NULL}
};
static struct PyModuleDef mathmodule = {
    PyModuleDef_HEAD_INIT, "math_api", NULL, -1, MathMethods
};
PyMODINIT_FUNC PyInit_math_api(void) {
    return PyModule_Create(&mathmodule);
}

编译为扩展模块:

gcc -shared -fPIC -o math_api.so math_api.c -I/usr/include/python3.9 -lpython3.9

Python调用:

import math_api
print(math_api.add(10, 20))  # 输出:30

关键API说明

函数 用途
PyArg_ParseTuple 解析Python元组参数为C变量
PyLong_FromLong 将C整数转换为Python整数对象
PyErr_SetString 设置Python异常
Py_INCREF/DECREF 管理对象引用计数
⚠️ 必须手动管理内存!引用计数错误会导致崩溃或内存泄漏;推荐使用 Py_BEGIN_ALLOW_THREADS 和 Py_END_ALLOW_THREADS 释放GIL以支持多线程。

五大方案综合对比

方案选择决策树

  • 已有C动态库?→ 选 ctypes 或 cffi(ABI模式)
  • 需兼容PyPy?→ 选 cffi
  • 需长期维护C扩展?→ 选 Cython
  • 集成大型C++库?→ 选 SWIG
  • 开发Python解释器扩展?→ 选 C API

性能与易用性矩阵

方案 学习曲线 性能 跨平台 适用场景
ctypes 低 中 高 快速集成、演示
cffi 中 高 高 高性能、PyPy兼容
Cython 中高 高 中 性能关键模块
SWIG 高 高 高 多语言绑定
C API 高 极高 低 解释器扩展

常见陷阱

网友高频问题解答

Q:Python怎么调用C函数返回字符串?

A:需注意内存管理!推荐返回 const char* 并用 strdup 复制,或使用 PyUnicode_FromString(C API)。ctypes中可声明 restype = ctypes.c_char_p,但Python会自动释放内存——仅适用于静态字符串。

Q:Windows下如何生成.dll?

A:使用MinGW-w64: gcc -shared -o math.dll math_lib.c;或用MSVC: cl /LD math_lib.c。注意Python需与GCC位数一致(32/64位)。

Q:如何传递数组?

A:ctypes中用 ctypes.c_int * n 创建数组;Cython中用 np.ndarray 并配合 memoryview;cffi支持 ffi.new("int[]", n)。注意避免拷贝开销。

Q:Python怎么调用C++类?

A:C++类无法直接被ctypes识别。需用C包装器(extern "C"),或使用 Cython(支持 cdef extern from "*.hpp")或 SWIG(原生支持C++)。

Q:调用后程序崩溃?

A:检查:① 动态库路径;② 函数签名是否匹配;③ 内存越界;④ GIL未释放导致死锁。建议先用C API的 PyErr_Print() 打印异常。