---
title: collectgarbage
summary: 控制垃圾收集. 结果取决于操作; 计数报告在 KiB 中的 Lua 内存.
section: reference
kind: api
status: reference
updated: 2026-10-26
tags: ["API","X4"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/","https://www.lua.org/manual/5.1/manual.html","https://luajit.org/ext_ffi_api.html"]
---
## 说明

控制垃圾收集. 结果取决于操作; 计数报告在 KiB 中的 Lua 内存.

## 返回值

| 类型 | 含义 |
| --- | --- |
| [`number`](wiki:type-number) \| [`boolean`](wiki:type-boolean) | 类型描述了声明的界面,而不是证明成功的游戏效果. |

[类型与方法](wiki:types)

## 参数

| 名称 | 类型 |
| --- | --- |
| `option?` | [`string`](wiki:type-string) |
| `argument?` | [`number`](wiki:type-number) |

没有什么. 标志着可选的参数;... 表示可变的参点数. 无效输入可能会导致Lua错误,而不是返回零.

## 示例与上下文

```lua
local kilobytes = collectgarbage("count")
```

**运行效果：** 千字节包含在KiB中的当前Lua内存使用量;这个数量取决于环境.

这段段没有打印或写日志信息. 显示的值是示例的预期结果.

看到 [语言基础](wiki:x4-code-basics), [类型和方法](wiki:types) 和 [Lua / MD事件](wiki:md-lua-bridge). 其他独立学习的例子. 没有项目源文件或私人实施碎片被分配到此引用.