附录D: 推荐资源
本文档整理Pybind11学习过程中推荐的优质资源，帮助深入学习和解决疑难问题。
D.1 官方文档链接
Section titled “D.1 官方文档链接”| 资源 | 链接 | 说明 |
|---|---|---|
| 官方文档 | https://pybind11.readthedocs.io | 最权威的学习资料 |
| GitHub仓库 | https://github.com/pybind/pybind11 | 源码、issue、讨论 |
| 官方示例 | https://github.com/pybind/pybind11/tree/master/tests | 完整示例代码 |
| CHANGELOG | https://github.com/pybind/pybind11/blob/master/CHANGELOG.md | 版本变更历史 |
| 教程 | 链接 | 难度 |
|---|---|---|
| pybind11作者视频 | https://www.youtube.com/watch?v=jQc3OCOq6gY | 入门 |
| FOSDEM 2024 pybind11 talk | https://www.youtube.com/watch?v=M-S8rKiKsKQ | 进阶 |
| Real Python pybind11教程 | https://realpython.com/python-bindings-with-pybind11/ | 入门 |
D.2 社区资源
Section titled “D.2 社区资源”| 平台 | 链接 | 说明 |
|---|---|---|
| Stack Overflow | https://stackoverflow.com/questions/tagged/pybind11 | 搜索[pybind11]标签 |
| GitHub Discussions | https://github.com/pybind/pybind11/discussions | 官方讨论区 |
| Discord | https://discord.gg/xFW7N6mv | pybind11官方频道 |
| 资源 | 链接 | 说明 |
|---|---|---|
| pybind11中文文档 | https://pybind11.readthedocs.io/zh_CN/latest/ | 中文翻译文档 |
| C++社区 | https://cppquiz.org | C++知识练习 |
| Python官方中文文档 | https://docs.python.org/zh-cn/3/ | Python文档 |
其他绑定方案对比
Section titled “其他绑定方案对比”| 方案 | 链接 | 适用场景 |
|---|---|---|
| nanobind | https://nanobind.readthedocs.io | 轻量级替代，Python 3.12+ |
| Cython | https://cython.org/ | 既有C++代码快速绑定 |
| cppy | https://github.com/nicholasbishop/cppy | 简化CPython API |
| SWIG | http://www.swig.org/ | 多语言绑定 |
D.3 学习路径
Section titled “D.3 学习路径”阶段一：入门（1-2周）
Section titled “阶段一：入门（1-2周）”目标：掌握基础绑定，能将简单C++函数导出到Python
- 阅读官方文档basics章节
- 完成第一个最小化示例
- 掌握模块定义、函数导出、基础类型转换
- 能够编译和导入模块
练习项目：
- 将一个C++数学库（如包含加减乘除的类）绑定到Python
- 实现一个带默认参数的函数
阶段二：核心概念（2-3周）
Section titled “阶段二：核心概念（2-3周）”目标：掌握类绑定、智能指针、异常处理
- 深入
py::class_的各类用法 - 掌握运算符重载、继承、虚函数
- 理解返回值策略和对象生命周期
- 学会处理C++异常和Python异常的相互转换
练习项目：
- 绑定一个含有成员函数、静态方法的类
- 实现一个从Python继承C++类并重写虚函数的例子
阶段三：数据类型（2-3周）
Section titled “阶段三：数据类型（2-3周）”目标：掌握STL容器、NumPy、迭代器
- 理解自动类型转换与opaque类型
- 掌握NumPy数组的双向转换
- 实现Python可迭代对象
- 理解缓冲区协议
练习项目：
- 将
std::vector<std::vector<double>>绑定为Python的嵌套list - 实现一个支持NumPy数组输入输出的图像处理函数
阶段四：高级特性（3-4周）
Section titled “阶段四：高级特性（3-4周）”目标：掌握GIL、线程、模板、模块组织
- 理解GIL机制和释放时机
- 掌握多线程下的线程局部存储
- 学会使用函数模板和类模板
- 能够组织大型多文件模块
练习项目：
- 实现一个带GIL释放的CPU密集计算函数
- 组织一个包含多个子模块的大型绑定项目
阶段五：实战与优化（持续）
Section titled “阶段五：实战与优化（持续）”目标：能够独立完成真实项目，懂得性能调优
- 学习性能分析和优化技巧
- 掌握调试技术（ASAN、valgrind）
- 学习打包分发（wheel、conda）
- 了解CI/CD自动化构建
实战项目：
- 完成一个完整的科学计算库绑定
- 实现一个机器学习推理模块
D.4 项目示例
Section titled “D.4 项目示例”真实世界的Pybind11项目
Section titled “真实世界的Pybind11项目”| 项目 | 链接 | 说明 |
|---|---|---|
| OpenCV | https://github.com/opencv/opencv | 计算机视觉库 |
| Eigen | https://github.com/xyobo/eigen | 线性代数（部分绑定） |
| pybind11_protobuf | https://github.com/pybind/pybind11_protobuf | Protocol Buffers绑定 |
| onnxruntime | https://github.com/microsoft/onnxruntime | ML推理引擎 |
| xtensor | https://github.com/xtensor-stack/xtensor | 多维数组表达式 |
| ** Dear PyGui** | https://github.com/hoffstadt/Dear_PyGui | GUI框架 |
教学示例仓库
Section titled “教学示例仓库”| 仓库 | 链接 | 说明 |
|---|---|---|
| pybind11 examples | https://github.com/pybind/pybind11/tree/master/tests | 官方测试用例 |
| pybind11 starter | https://github.com/nicholasbishop/pybind11_starter | 最小化项目模板 |
| scientific-python-bindings | https://github.com/ThePythonDjangoCom/scientific-python-bindings | 科学计算示例 |
D.5 推荐书籍
Section titled “D.5 推荐书籍”| 书籍 | 说明 |
|---|---|
| C++ Primer | C++入门经典 |
| Effective C++ | C++最佳实践 |
| Effective Modern C++ | 现代C++最佳实践 |
| The C++ Programming Language | Bjarne Stroustrup著 |
Python相关
Section titled “Python相关”| 书籍 | 说明 |
|---|---|
| Fluent Python | Python进阶必读 |
| Python Cookbook | 实用Python编程 |
| CPython Internals | 理解Python内部机制 |
| 书籍 | 说明 |
|---|---|
| Latency Numbers | 性能调优参考 |
| Linux性能优化 | BPF与性能工具 |
持续学习建议
Section titled “持续学习建议”- 关注官方更新：pybind11活跃开发，新特性持续加入
- 阅读源码：理解内部机制有助于解决疑难问题
- 参与社区：GitHub Discussions是获取帮助的好地方
- 实践为主：边学边做比纯看书更有效
提示：如果你使用Python 3.12+且项目不需要兼容旧版Python，nanobind是pybind11作者的新项目，更轻量、编译更快、错误信息更好，值得关注。