gc – 控制垃圾回收器

该模块实现相应CPython模块的子集，如下所示。更多信息，请参见: |CPython文档| python:gc.

函数

gc.enable()

启用垃圾自动收集。

gc.disable()

禁用垃圾自动收集。堆内存仍可分配，仍可使用 gc.collect() 手动启动垃圾回收。

gc.collect()

运行垃圾回收。

gc.mem_alloc()

返回分配的堆RAM的字节数量。

gc.mem_free()

与CPython区别

此函数为MicroPython扩展。

gc.mem_free()

返回可用的堆RAM的字节数量。

与CPython区别

此函数为MicroPython扩展。

gc.threshold([amount])

设置或查询额外的GC分配阈值。通常，仅在无法满足新分配时，才会触发一个集合，即内存不足（OOM）时。若调用该函数，除OOM之外， 每次分配字节数之后都会触发一个集合（总之，自前一段时间后，已分配了相当数量的字节）。数量通常被指定为少于满堆大小， 其目的是在堆耗尽前触发一个集合，且希望前期集合能够防止过度内存碎片。这是一种启发式的度量方法，其效果随应用程序不同而不同， 其数量参数的最优值也不尽相同。

无参数调用该函数将返回阈值的当前值。-1值表示禁用配置阈值。

与CPython区别

该函数为MicroPython的扩展。CPython有一个类似函数 set_threshold() ，但由于不同的GC实现，其签名与语义也不同。