Lua 表操作：table.insert() 与 table.remove()

Lua 中最核心的数据结构是表，它既可以当作字典使用，也可以当作数组（列表）使用。当作为数组使用时，table.insert() 和 table.remove() 是两个最基础且最重要的操作函数。掌握它们的使用方法，能让你高效地管理数据序列。

一、 插入数据：table.insert()

table.insert() 用于向数组中添加元素。根据是否指定位置，它有两种截然不同的行为。

1. 末尾追加（常规用法）

如果不指定插入位置，函数会将新元素直接添加到数组的末尾。这是最常用的方式，相当于其他语言中的 push 或 append 操作。

语法：table.insert(list, value)

1. 准备 一个初始数组，例如 local fruits = {"Apple", "Banana"}。
2. 执行 插入操作，输入 table.insert(fruits, "Orange")。
3. 查看 结果，数组变为 {"Apple", "Banana", "Orange"}，长度由 2 变为 3。

local list = {10, 20, 30}
table.insert(list, 40)
-- 结果: list = {10, 20, 30, 40}

2. 指定位置插入（中间插入）

如果在第二个参数指定位置 pos，函数会将新元素插入到该位置，并将原位置及之后的元素依次向后移动。

语法：table.insert(list, pos, value)

1. 确认 目标数组，例如 local nums = {1, 2, 4}。
2. 调用 插入函数，输入 table.insert(nums, 2, 3)。这表示在索引 2 的位置插入数值 3。
3. 观察 变化：
   • 原索引 2 的元素 2 及后续元素会自动后移。
   • 最终结果为 {1, 3, 2, 4}。

local nums = {1, 5}
table.insert(nums, 1, 0) -- 在索引1处插入0
-- 结果: nums = {0, 1, 5}

二、 移除数据：table.remove()

table.remove() 用于从数组中删除元素。删除元素后，数组会自动调整后续元素的索引，保证索引的连续性（即不会留下“空洞”）。

1. 移除末尾元素

如果不指定位置，默认移除数组最后一个元素，并返回该元素的值。这相当于其他语言中的 pop 操作。

语法：table.remove(list)

1. 假设 数组为 local stack = {"A", "B", "C"}。
2. 执行 移除操作，输入 local last = table.remove(stack)。
3. 检查 变量 last，其值为字符串 "C"。
4. 检查 数组 stack，现在变为 {"A", "B"}，长度减 1。

2. 移除指定位置元素

如果指定位置 pos，函数会移除该位置的元素，后续元素依次前移填补空缺，并返回被移除的元素。

语法：table.remove(list, pos)

1. 定义 数组 local ids = {101, 102, 103, 104}。
2. 删除 索引为 2 的元素，输入 local removed = table.remove(ids, 2)。
3. 分析 过程：
   • 索引 2 的值 102 被移除并赋值给 removed。
   • 原索引 3 的 103 前移至索引 2。
   • 原索引 4 的 104 前移至索引 3。
4. 确认 最终数组为 {101, 103, 104}。

三、 索引移动逻辑解析

当在数组中间进行插入或删除操作时，Lua 会自动维护数组的连续性。理解这一过程有助于优化代码性能。

1. 插入时的后移逻辑

当在位置 pos 插入元素时，索引变化遵循以下逻辑：

$$ \text{新索引 } i' = \begin{cases} i+1, & \text{如果 } i \ge \text{pos} \\ i, & \text{如果 } i < \text{pos} \end{cases} $$

这意味着，插入位置越靠前，需要移动的元素越多。在极大的数组头部频繁插入数据会降低性能。

2. 删除时的前移逻辑

当删除位置 pos 的元素时，后续元素的索引更新过程如下：

这个过程确保了数组不会出现中间断层的现象。例如，删除索引 2 后，原本索引 3 的元素立刻变成索引 2。

四、 参数对照与差异

这两个函数虽然功能相反，但在参数处理上有相似的规则。

操作函数参数对照表

注意：对于 table.insert，如果只有两个参数，第二个参数被视为值（插入末尾）；如果有三个参数，第二个参数被视为位置。

五、 实战注意事项

在实际开发中，正确使用这两个函数需要注意以下细节。

1. 遍历时删除陷阱

禁止 在数值 for 循环或 ipairs 遍历中直接按索引删除元素，这会导致索引错乱或跳过元素。

错误示例：

local t = {1, 2, 3, 4, 5}
for i = 1, #t do
    if t[i] % 2 == 0 then
        table.remove(t, i) -- 删除后，后面的元素前移，i 的自增会跳过下一个元素
    end
end

正确做法：采用 从后往前遍历的方式。

local t = {1, 2, 3, 4, 5}
for i = #t, 1, -1 do
    if t[i] % 2 == 0 then
        table.remove(t, i) -- 从后往前删，不影响前面未遍历元素的索引
    end
end

2. 表长度的判定

Lua 的 # 运算符依据 nil 来判断数组结束。table.insert 和 table.remove 会自动处理长度，无需手动计算。避免 在数组中间手动赋值 nil（如 t[5] = nil），这会导致 #t 计算结果不确定。始终使用 table.remove 来保持数组的健壮性。