c++怎么使用pybind11来封装库给Python调用_c++与Python混合编程接口开发教程

浅伟大大_1713

浅伟大大_1713

2025-11-27

282人浏览

原创

使用pybind11可将C++代码封装为Python模块,通过编写绑定代码并编译为共享库,实现高效调用。首先安装pybind11并获取头文件路径,然后在C++中定义函数和类,并使用PYBIND11_MODULE宏导出;接着通过g++或CMake编译生成模块文件;最后在Python中直接导入使用。支持STL容器、异常映射、默认参数及NumPy集成等高级特性,使C++功能在Python中如原生模块般运行。

c++怎么使用pybind11来封装库给python调用_c++与python混合编程接口开发教程

用 C++ 结合 pybind11 封装库供 Python 调用,是实现高性能混合编程的常用方式。pybind11 是一个轻量级头文件库,能将 C++ 函数、类、变量等自然地暴露给 Python,且语法简洁,兼容 C++11 及以上标准。

安装 pybind11

使用 pybind11 前需确保已安装。推荐通过 pip 安装:

pip install pybind11

开发时还需包含其头文件。若通过 pip 安装,可通过以下命令查看头文件路径:

python -m pybind11 --includes

该命令输出编译时需添加的 include 路径,如 -I/usr/include/python3.8 和 -I/path/to/pybind11/include。

编写简单的 C++ 封装代码

创建一个 C++ 文件(例如 example.cpp),封装一个加法函数和一个简单类:

#include <pybind11>
#include <string><p>int add(int a, int b) {
return a + b;
}</p>
<p>class Calculator {
public:
explicit Calculator(const std::string& name) : name<em>(name) {}
int multiply(int x, int y) {
return x * y;
}
std::string greet() const {
return "Hello from " + name</em>;
}
private:
std::string name_;
};</p>
<p>// 绑定模块
PYBIND11_MODULE(example, m) {
m.doc() = "A simple example module";</p>
<pre class="brush:php;toolbar:false;">// 绑定函数
m.def("add", &add, "A function that adds two integers");

// 绑定类
pybind11::class_<calculator>(m, "Calculator")
    .def(pybind11::init<const std::string>())
    .def("multiply", &Calculator::multiply)
    .def("greet", &Calculator::greet);</const></calculator>

}

编译生成 Python 模块

需要将 C++ 代码编译为 Python 可导入的共享库(.so 或 .pyd)。可使用 g++ 手动编译或借助 CMake。

方法一:使用 g++ 直接编译(适用于简单项目)

g++ -O3 -Wall -shared -std=c++11 -fPIC `python3 -m pybind11 --includes` example.cpp -o example`python3-config --extension-suffix`

说明:

  • -shared:生成共享库
  • -fPIC:生成位置无关代码
  • python3 -m pybind11 --includes:自动获取包含路径
  • python3-config --extension-suffix:确保生成的文件名符合当前 Python 版本(如 example.cpython-310-x86_64-linux-gnu.so)

方法二:使用 CMake(推荐用于复杂项目)

Camoufox Open Source Anti-Detect Browser for Python Automation
Camoufox Open Source Anti-Detect Browser for Python Automation

Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。

下载

创建 CMakeLists.txt:

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

然后执行:

mkdir build && cd build
cmake .. && make

在 Python 中调用封装的模块

编译成功后,当前目录会生成 example.so(Linux/macOS)或 example.pyd(Windows)。在 Python 中直接导入:

import example
<p>print(example.add(2, 3))  # 输出: 5</p><p>calc = example.Calculator("MyCalc")
print(calc.greet())        # 输出: Hello from MyCalc
print(calc.multiply(4, 5)) # 输出: 20</p>

支持高级特性(可选扩展)

pybind11 支持更多功能,如:

  • STL 容器自动转换:vector、map 等可直接传递
  • 异常处理:C++ 异常可映射为 Python 异常
  • 默认参数、重载函数:支持函数重载与默认值
  • NumPy 集成:通过 pybind11/eigen.h 或 numpy.h 支持数组高效传递

例如,支持 vector 的函数:

#include <pybind11>
#include <vector><p>std::vector<int> filter_positive(const std::vector<int>& input) {
std::vector<int> result;
for (int x : input)
if (x > 0) result.push_back(x);
return result;
}</int></int></int></p>
<p>// 在 PYBIND11_MODULE 中添加
m.def("filter_positive", &filter_positive);</p></vector></pybind11>

Python 中可直接传 list,返回 list。

基本上就这些。只要写好绑定代码,编译正确,就能在 Python 中像原生模块一样使用 C++ 功能。不复杂但容易忽略细节,比如文件命名和编译选项。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c++ linux python windows macos

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

2023.10.09

3730

5

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

2024.12.20

8443

6

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

2024.12.23

10182

11

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

2025.07.23

5407

16

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3268

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

5609

12

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.29

3909

9

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

2026.01.19

506

15

golang map内存释放
golang map内存释放

本专题整合了golang map内存相关教程,阅读专题下面的文章了解更多相关内容。

2025.09.05

770

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习