哪些SWIG函数需用%newobject避免Python内存泄漏及配置方法

1. 需要标注%newobject的场景（无官方固定列表，看核心判断标准） #

没有官方给出的固定SWIG原语列表，核心判断逻辑是：当函数返回的是由SWIG/C++代码在堆上分配的新对象（比如通过new关键字、SWIG_NewObjectPtr创建的对象），且需要Python垃圾回收器接管该对象的内存所有权时，就需要加%newobject。常见的典型场景包括：

• 自定义的工厂函数（比如返回new MyClass()的函数）
• 使用%factory指令生成的对象创建函数
• 在%extend中新增的、返回新分配对象的成员函数
• 手动用SWIG_NewObjectPtr创建对象并返回的自定义包装函数

如果函数返回的是栈对象、全局对象、或者调用方已经持有所有权的对象（比如返回类成员变量的引用），绝对不能加%newobject，否则会导致Python错误释放内存，触发崩溃。

2. 不需要盲目标注所有返回值的函数 #

盲目标注所有返回值的函数是非常危险的操作。比如当函数返回一个已存在的对象时，%newobject会让Python错误地认为自己拥有该对象的所有权，导致重复释放内存，引发程序崩溃。必须只给确实返回新分配对象的函数添加该指令。

3. 全局/按文件应用%newobject的可行性 #

可以全局或按范围应用，但务必谨慎：

• 全局应用：使用%newobject *;指令，会给所有返回指针/对象的函数加上%newobject。这种方式风险极高，除非你能确保项目中所有返回对象的函数都是返回新分配的内存，否则绝对不推荐使用。
• 按文件/范围应用：可以针对特定命名空间、类或头文件范围应用，比如：

  // 给MyNamespace下的所有函数添加%newobject
  %newobject MyNamespace::*;
  %include "my_namespace_header.h"
  
  // 给MyClass的所有成员函数添加%newobject
  %newobject MyClass::*;
  

  这种方式比全局安全，但也要提前确认范围内的所有函数都符合“返回新分配对象”的要求。

内容的提问来源于stack exchange，提问作者uuu777