本文旨在帮助开发者理解并解决在使用 C++ 扩展 Python 时可能出现的内存泄漏问题。通过一个将赤经赤纬坐标转换为笛卡尔坐标的示例，详细解释了如何正确管理 Python 对象的引用计数，从而避免内存泄漏，确保 Python 解释器的内存稳定。
在使用 C++ 编写 Python 扩展时，内存管理是一个至关重要的环节。不正确的引用计数管理会导致内存泄漏，最终影响 Python 解释器的性能。本教程将通过一个实际的例子，深入探讨如何避免这类问题。
示例：赤经赤纬坐标转换为笛卡尔坐标
假设我们需要编写一个 C++ 函数，该函数接收两个 NumPy 数组（分别表示赤经和赤纬），并计算出笛卡尔坐标系的 x 坐标，并将结果存储在一个新的 NumPy 数组中返回。
以下是一个可能导致内存泄漏的实现：
立即学习“Python免费学习笔记（深入）”；
extern "C" PyObject *radec_to_xyz(PyObject *self, PyObject *args) { // 解析输入参数 PyArrayObject *ra_arrobj, *dec_arrobj; if (!PyArg_ParseTuple(args, "O!O!", &PyArray_Type, &ra_arrobj, &PyArray_Type, &dec_arrobj)) { PyErr_SetString(PyExc_TypeError, "invalid arguments, expected two numpy arrays"); return nullptr; } // 省略了对输入数组类型、维度和大小的检查 npy_intp size = PyArray_SIZE(ra_arrobj); // 创建输出 NumPy 数组 PyObject *x_obj = PyArray_EMPTY(1, &size, NPY_FLOAT64, 0); if (!x_obj) return nullptr; Py_XINCREF(x_obj); // 潜在的内存泄漏点 // 获取数组指针 double *ra_array = static_cast(PyArray_DATA(ra_arrobj)); double *dec_array = static_cast(PyArray_DATA(dec_arrobj)); double *x_array = static_cast(PyArray_DATA(reinterpret_cast(x_obj))); // 计算坐标 for (npy_intp i = 0; i < size; ++i) { double cos_ra = cos(ra_array[i]); double cos_dec = cos(dec_array[i]); x_array[i] = cos_ra * cos_dec; } // 返回结果 return Py_BuildValue("O", x_obj);}
问题分析：引用计数错误
上述代码的问题在于 Py_XINCREF(x_obj) 的使用。Py_BuildValue(“O”, x_obj) 函数本身会增加 x_obj 的引用计数。因此，手动调用 Py_XINCREF(x_obj) 会导致引用计数增加两次，使得 Python 垃圾回收器无法正确地回收 x_obj 所占用的内存，从而造成内存泄漏。
解决方案：移除多余的引用计数增加
正确的做法是移除 Py_XINCREF(x_obj) 这一行代码。修改后的代码如下：
extern "C" PyObject *radec_to_xyz(PyObject *self, PyObject *args) { // 解析输入参数 PyArrayObject *ra_arrobj, *dec_arrobj; if (!PyArg_ParseTuple(args, "O!O!", &PyArray_Type, &ra_arrobj, &PyArray_Type, &dec_arrobj)) { PyErr_SetString(PyExc_TypeError, "invalid arguments, expected two numpy arrays"); return nullptr; } // 省略了对输入数组类型、维度和大小的检查 npy_intp size = PyArray_SIZE(ra_arrobj); // 创建输出 NumPy 数组 PyObject *x_obj = PyArray_EMPTY(1, &size, NPY_FLOAT64, 0); if (!x_obj) return nullptr; // Py_XINCREF(x_obj); // 移除此行 // 获取数组指针 double *ra_array = static_cast(PyArray_DATA(ra_arrobj)); double *dec_array = static_cast(PyArray_DATA(dec_arrobj)); double *x_array = static_cast(PyArray_DATA(reinterpret_cast(x_obj))); // 计算坐标 for (npy_intp i = 0; i < size; ++i) { double cos_ra = cos(ra_array[i]); double cos_dec = cos(dec_array[i]); x_array[i] = cos_ra * cos_dec; } // 返回结果 return Py_BuildValue("O", x_obj);}
总结与注意事项
理解引用计数： 在 C++ 扩展中，理解 Python 对象的引用计数至关重要。每个 Python 对象都有一个引用计数，当引用计数降为 0 时，该对象会被垃圾回收器回收。Py_INCREF 和 Py_DECREF： 使用 Py_INCREF 增加引用计数，使用 Py_DECREF 减少引用计数。务必确保成对使用，避免内存泄漏或提前释放。Py_XINCREF 和 Py_XDECREF 是线程安全的版本，可以处理空指针。Py_BuildValue： Py_BuildValue 等函数会自动处理返回对象的引用计数，无需手动增加。所有权： 明确对象的所有权。如果你的 C++ 代码创建了一个新的 Python 对象并返回，那么通常需要将所有权转移给 Python 解释器，并确保引用计数正确。测试： 编写测试用例来验证 C++ 扩展的内存管理。可以使用内存分析工具来检测内存泄漏。
通过遵循这些原则，可以有效地避免在使用 C++ 扩展 Python 时出现内存泄漏问题，从而确保应用程序的稳定性和性能。
以上就是使用 C++ 扩展 Python 时理解内存泄漏的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1364020.html
微信扫一扫 
支付宝扫一扫 
![[python]windows上通过whl文件安装triton模块](https://www.chuangxiangniao.com/wp-content/uploads/2025/11/175910816437120.jpg)
![[python]windows上通过whl文件安装triton模块](https://www.chuangxiangniao.com/wp-content/uploads/2025/11/175679953098868-3.png)
