Pybind11可高效将C++代码暴露给Python，提升性能。1. 通过pip或conda安装后包含头文件即可使用；2. 编写C++函数并用PYBIND11_MODULE和m.def导出；3. 用setuptools编译为共享库，Python可直接导入调用；4. 支持类绑定，如封装Person类并暴露构造函数与成员方法；5. 提供默认参数、STL容器转换、异常处理和NumPy支持等高级功能；6. 建议简化接口、明确返回值策略、拆分模块文件并生成类型提示。

用C++为Python编写扩展能显著提升性能关键部分的运行速度。Pybind11 是目前最流行、最简洁的工具之一，它允许你用极少量的 C++ 代码将 C++ 类和函数暴露给 Python。相比传统的 Python/C API 或 Boost.Python，Pybind11 更轻量、易用且功能强大。

1. 安装 Pybind11

Pybind11 是一个头文件库，不需要编译，只需包含即可使用。推荐通过包管理器安装：

• pip 安装（推荐）： pip install pybind11
• conda 安装： conda install pybind11 -c conda-forge
• 从源码编译： 从 GitHub 克隆并手动引入头文件目录

安装后，在项目中包含 <pybind11></pybind11> 即可开始使用。

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

创建一个简单的 C++ 文件（例如 example.cpp），导出一个加法函数：

Openflow

一键极速绘图，赋能行业工作流

88 查看详情

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

说明：

• PYBIND11_MODULE 定义一个 Python 可导入的模块，第一个参数是模块名（与编译后的文件名一致），第二个是模块对象 m。
• m.def() 将 C++ 函数绑定为 Python 函数。

3. 编译生成 Python 模块

需要将 C++ 代码编译为 Python 可加载的共享库（如 .so 或 .pyd）。推荐使用 setuptools 构建。

创建 setup.py：

from setuptools import setup, Extension
from pybind11.setup_helpers import Pybind11Extension, build_ext
from pybind11 import get_cmake_dir
import pybind11
<p>ext_modules = [
Pybind11Extension(
"example",
["example.cpp"],
),
]</p><p>setup(
name="example",
ext_modules=ext_modules,
cmdclass={"build_ext": build_ext},
zip_safe=False,
)</p>

然后运行：

python setup.py build_ext --inplace

成功后会生成 example.cpython-xxx.so（Linux/macOS）或 example.pyd（Windows），可直接在 Python 中导入：

import example
print(example.add(2, 3))  # 输出 5

4. 绑定 C++ 类到 Python

Pybind11 支持完整封装 C++ 类。例如定义一个 Person 类：

#include <pybind11/pybind11.h>
#include <string>
<p>class Person {
public:
Person(const std::string &name, int age) : name(name), age(age) {}
void setName(const std::string &name) { this->name = name; }
const std::string &getName() const { return name; }
void setAge(int age) { this->age = age; }
int getAge() const { return age; }</p><p>private:
std::string name;
int age;
};</p><p>PYBIND11<em>MODULE(example, m) {
pybind11::class</em><Person>(m, "Person")
.def(pybind11::init<const std::string&, int>())
.def("setName", &Person::setName)
.def("getName", &Person::getName)
.def("setAge", &Person::setAge)
.def("getAge", &Person::getAge);
}</p>

在 Python 中使用：

p = example.Person("Alice", 30)
print(p.getName())  # Alice
p.setAge(31)
print(p.getAge())   # 31

5. 高级功能简要介绍

• 默认参数： 直接支持 C++ 函数的默认参数，自动映射到 Python。
• STL 容器转换： 包含 <pybind11></pybind11> 后，std::vector、std::map 等可自动转为 Python list/dict。
• 异常处理： 使用 m.attr("builtins").attr("ValueError") 抛出 Python 异常，或用 py::wrap_exception 包装 C++ 异常。
• NumPy 支持： 包含 <pybind11></pybind11> 可传递 NumPy 数组，实现高效数据共享。

6. 最佳实践建议

• 保持接口简单，避免暴露复杂的 C++ 特性（如模板、多重继承）给 Python。
• 使用 pybind11::return_value_policy 明确控制对象生命周期（如 reference_internal 避免拷贝）。
• 模块组织清晰，按功能拆分多个 .cpp 文件并在 setup.py 中统一编译。
• 添加类型提示支持：使用 pybind11-stubgen 生成 .pyi 文件，提升 IDE 体验。

基本上就这些。Pybind11 让 C++ 和 Python 的交互变得直观高效，适合科学计算、高性能算法、已有 C++ 库封装等场景。掌握基础绑定方法后，查阅官方文档即可应对大多数需求。

以上就是c++++如何为Python编写C++扩展_c++ Pybind11使用指南的详细内容，更多请关注其它相关文章！

# 头文件  # 关键词权重排名怎么查  # 市场营销推广选题方向  # seo排名选择  # 晋中大搜seo报价  # 建设网站高端定制  # 西安抖音推广官方网站  # 坪山网站营销推广  # 胶州网站首页优化  # 普通网站建设的内容  # 肥东营销推广推荐  # 网络编程  # 有什么区别  # 尼克  # 第三方  # 可直接  # linux  # 微软  # 第一个  # 何为  # 绑定  # cos  # win  # macos  # c++  # mac  # 工具  # github  # windows  # git  # python 

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

相关推荐： 解决 Vaadin 8 中大文件音频播放与定位时出现的 IOException  深入理解J*a合成构造器：何时以及为何阻止其生成  Golang如何实现微服务鉴权与权限控制_Golang微服务鉴权与权限管理实践  Yandex免登录官网入口_俄罗斯Yandex搜索引擎直达链接  夸克浏览器网页版最新地址 夸克浏览器官方入口合集  如何优雅地解决Livewire文件上传难题？SpatieLivewireFilepond让一切变得简单  C++如何使用AddressSanitizer(ASan)_C++调试工具中检测内存访问错误的利器  J*aScript DOM操作：高效清空列表元素的策略与实践  必由学官网首页入口 必由学教师网页版登录指南  品牌机怎么重装系统 联想/戴尔/惠普笔记本恢复出厂系统教程  PostgreSQL海量数据高效导入策略：Python与Django实践指南  Golang如何安装Swagger工具_GoSwagger文档生成环境  深入理解J*aScript Promise异步执行与微任务队列  Composer的 "licenses" 命令如何帮助你遵守开源协议_检查项目依赖的许可证合规性  优化 Python 函数中的条件逻辑：解决 if-else 嵌套与参数选择问题  J*aScript中管理异步API调用：确保操作顺序与数据一致性  三星GalaxyZFold5怎样在相册制作折叠屏分镜_iPhone三星GalaxyZFold5相册制作折叠屏分镜【创意编辑】  一加 Nord 5 隐私权限异常_一加 Nord 5 系统安全优化  妖精动漫免费平台 妖精动漫官网资源观看网址  新三国志曹操传110级星符试炼夏侯渊极难攻略  c++ 命名空间怎么用 c++ namespace使用指南  可靠CSGO开箱平台解析 CSGO开箱网合集  如何使用Go和Martini动态服务解码后的图片  vivo云服务网页版登录 怎么登录vivo云服务网页版  12306选座怎么选到特殊座位_12306特殊座位选择注意事项  J*aScript数据结构转换：将对象数组按类别分组  冬*霸灯泡不亮怎么办_浴霸取暖灯一盏不亮的灯座清洁修复法  凉拌黄瓜怎么拌更入味 凉拌黄瓜简单家常做法  如何为你的Composer包编写自动化测试_集成PHPUnit到Composer的scripts工作流  在命令行怎么运行html项目_命令行运行html项目方法【教程】  Python getattr() 异常处理深度解析：避免程序意外退出  css绝对定位元素脱离父容器怎么办_确保父元素position非static  谷歌学术网站直达地址 谷歌学术搜索网页版一键进入  微信网页版官方快速登录入口 微信网页版网页版账号直达  Golang如何实现状态模式管理对象状态_Golang State模式实现技巧  c++中的const_cast和reinterpret_cast怎么用_c++四种类型转换  飞书妙记怎样用语音转文字速记_飞书妙记用语音转文字速记【速记方法】  lar*el怎么安全地存储和获取配置文件中的敏感信息_lar*el敏感信息安全存储方法  铁路12306改签能改到更早的车次吗_铁路12306改签提前车次规则  UE5.7引擎表现爆炸优化无敌！5090跑4K稳定60FPS  Go RPC HTTP服务正确实现与常见陷阱解析  海棠电脑版入口_通过电脑访问海棠官网阅读  漫蛙2漫画入口 漫蛙正版网页漫画直达网址  c++ 获取系统当前时间 c++时间戳获取方法  PyTorch模型训练效果不佳？深入剖析常见错误与调试技巧  解决 MongoDB 聚合查询中对象数组 _id 匹配问题  拼多多购物车商品数量无法修改如何处理 拼多多购物车操作优化方法  AO3官方可用镜像 Archive of Our Own网页版最新入口  QQ邮箱官网登录入口 QQ邮箱网页版邮箱快速登录  解决J*aScript中重复选择项的确认对话框显示问题