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

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。

万彩商图

专为电商打造的AI商拍工具，快速生成多样化的高质量商品图和模特图，助力商家节省成本，解决素材生产难、产图速度慢、场地设备拍摄等问题。

212 查看详情万彩商图

在 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的详细内容，更多请关注其它相关文章！

# c++扩展 # pybind11 # red # win # c++ # 工具 # windows # python # linux # 蜂蜜营销推广财务分析 # 延庆区网站建设商家信息 # seo经典案例分析seo公司 # 什么样的网站好优化公司 # seo深圳优化公司 # 门窗行业网站建设流程 # 游戏营销推广方式 # 喀什抖音推广seo # 校园关键词排名方案 # 上海网站推广贵不贵知乎 # 第一个 # 你可以 # 是目前 # 如果你 # 是一个 # 音频处理 # 的是 # 绑定 # 头文件 # 可在

相关栏目：【 Google疑问12 】【 Facebook疑问10 】【优化推广96088 】【技术知识133117 】【 IDC资讯59369 】【网络运营7196 】【 IT资讯61894 】

2025-11-21

4008744355

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

安装 Pybind11

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

编译生成 Python 模块

在 Python 中使用扩展模块

导出 C++ 类到 Python

处理复杂类型与 STL 容器

了解您产品搜索量及市场趋势，制定营销计划

同行竞争及网站分析保障您的广告效果

提交您的需求，1小时内享受我们的专业解答。

运城市盐湖区信雨科技有限公司

4008744355

服务/方案/案例/支持

关于我们

Notice