C++怎么编写Python的C++扩展模块_C++与Python混合编程之Pybind11

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

C++怎么编写Python的C++扩展模块_C++与Python混合编程之Pybind11

2025-11-21

浏览次数：次

返回列表

Pybind11是目前最简洁高效的C++编写Python扩展模块的工具，通过极少量代码即可将C++函数、类、STL容器等暴露给Python。使用PYBIND11_MODULE定义模块，m.def()导出函数，py::class_封装类，配合#include 实现vector、map等自动转换。通过CMake构建生成.so或.pyd文件后，可在Python中如原生模块般调用，显著提升性能，适用于算法加速与C++项目集成。

c++怎么编写python的c++扩展模块_c++与python混合编程之pybind11

要用C++编写Python扩展模块，Pybind11 是目前最简洁高效的工具之一。它允许你用极少量的C++代码将C++类、函数、对象暴露给Python，实现高性能混合编程。相比传统的 Python C API 或 Boost.Python，Pybind11 更轻量、易用且功能强大。

安装 Pybind11

Pybind11 可以通过 pip 安装，也可以作为头文件直接集成到项目中：

pip install pybind11

安装后，你可以包含其头文件来使用。如果你使用 CMake，推荐方式是通过 find_package(pybind11) 集成。

编写第一个 C++ 扩展模块

下面是一个简单的例子，将一个 C++ 函数导出为 Python 模块：

example.cpp:

#include <pybind11/pybind11.h>
<p>int add(int a, int b) {
return a + b;
}</p><p>namespace py = pybind11;
PYBIND11_MODULE(example, m) {
m.doc() = "pybind11 example plugin";
m.def("add", &add, "A function that adds two numbers");
}

这里：
- PYBIND11_MODULE 定义了一个名为 example 的 Python 模块。
- m.def() 将 C++ 函数 add 绑定为 Python 可调用函数。

编译生成 Python 模块

有几种方式可以编译这个模块。最简单的是使用 pybind11 提供的工具链。

使用 CMake 编译（推荐）：

CMakeLists.txt:

cmake_minimum_required(VERSION 3.10)
project(example)
<p>find_package(pybind11 REQUIRED)</p><p>pybind11_add_module(example example.cpp)

然后执行：

mkdir build
cd build
cmake ..
make

成功后会生成 example.cpython-xxx.so（Linux）或 example.pyd（Windows），可在 Python 中直接 import。

CA.LA

第一款时尚产品在线设计平台，服装设计系统

94 查看详情 CA.LA

在 Python 中使用扩展模块

编译完成后，在 Python 中像普通模块一样导入：

import example
print(example.add(3, 4))  # 输出: 7

你会发现这个函数和原生 Python 函数一样调用自然，但底层是 C++ 实现，性能更高。

导出 C++ 类到 Python

Pybind11 支持完整封装 C++ 类。例如：

#include <pybind11/pybind11.h>
<p>class MyClass {
public:
MyClass(const std::string &name) : name(name) {}
void set_name(const std::string &n) { name = n; }
std::string get_name() const { return name; }
private:
std::string name;
};</p><p>namespace py = pybind11;
PYBIND11<em>MODULE(example, m) {
py::class</em><MyClass>(m, "MyClass")
.def(py::init<const std::string &>())
.def("set_name", &MyClass::set_name)
.def("get_name", &MyClass::get_name);
}

在 Python 中使用：

obj = example.MyClass("test")
print(obj.get_name())  # 输出: test
obj.set_name("hello")
print(obj.get_name())  # 输出: hello

构造函数、成员方法都可直接绑定，支持重载、属性访问等高级特性。

处理复杂类型与 STL 容器

Pybind11 支持自动转换常见 STL 类型。需包含对应头文件：

#include <pybind11/stl.h>

之后，C++ 的 std::vector、std::string、std::map 等会自动转换为 Python 的 list、str、dict。

例如：

std::vector<int> get_numbers() {
    return {1, 2, 3, 4};
}
<p>m.def("get_numbers", &get_numbers);

Python 调用时返回的就是 list。

基本上就这些。Pybind11 让 C++ 与 Python 混合编程变得非常直观。只要写好 C++ 逻辑，几行绑定代码就能在 Python 中高速调用，适合算法加速、接口封装、已有 C++ 项目集成等场景。

以上就是C++怎么编写Python的C++扩展模块_C++与Python混合编程之Pybind11的详细内容，更多请关注其它相关文章！

# 是一个 # 关键词排名哪家见效快 # 推广网站怎么介绍好看 # 展会网站怎么推广好呢 # 建设网站翻译英文 # 哈尔滨百度搜索网站优化 # 关键词seo排名火乙星26 # 黄浦区公司网站建设推广 # 云南网络营销推广 # 广州汽车seo方法 # 淘客网站seo优化 # 第一个 # 你可以 # 是目前 # 如果你 # pybind11 # 的是 # 如何用 # 绑定 # 头文件 # 可在 # red # win # c++ # 工具 # windows # python # linux # c++扩展

相关栏目：【科技资讯46185 】【网络学院92790 】

上一篇：什么是GML（地理标记语言）一种基于xml的地理信息标准

下一篇：c++如何调用C语言的函数_c++与C语言混合编译与函数调用方法

首页

关于我们

产品展示

咨询研究

新闻中心

留言板

联系我们

新闻中心 NEWS CENTER

C++怎么编写Python的C++扩展模块_C++与Python混合编程之Pybind11

安装 Pybind11

编写第一个 C++ 扩展模块

编译生成 Python 模块

在 Python 中使用扩展模块

导出 C++ 类到 Python

处理复杂类型与 STL 容器