【入门夯实】table.insert的位置参数：末尾追加与中间插入

学员常见误区

table.insert 有两种调用形态：insert(t, v) 末尾追加、insert(t, pos, v) 指定位置插入，学员把两种形态混着记，写出 insert(t, #t, v) 想插到末尾——实际 #t 是倒数第二个位置，新元素插在末位元素前面，队列顺序悄悄错一位。还有人写 insert(t, #t + 5, v)，位置超过表长加一，直接报错 bad argument。错误场景：

local queue = {"甲", "乙", "丙"}
table.insert(queue, #queue, "丁")

结果 queue 是 {"甲", "乙", "丁", "丙"}，丁没有排到末尾。

正确姿势

末尾追加一律用两参形态，让表自己管长度；只有插队、插序这类需求才用三参形态。沙巴克攻城报名：正常报名追加队尾，赞助 10 万金币的行会插队到首位。示例代码如下：

local signs = {}
local function signUp(gName)
    table.insert(signs, gName)
    sendmsg(nil, 1, gName .. " 报名攻城，当前第 " .. #signs .. " 位。")
end
local function signUpFirst(gName)
    table.insert(signs, 1, gName)
    sendmsg(nil, 1, gName .. " 赞助 10 万金币插队，当前第 1 位。")
end

三参形态插入位置 1 时，原队首及后续元素整体后移一位，表长加一。示例代码如下：

local t = {"A", "B", "C"}
table.insert(t, 2, "X")

t 变为 {"A", "X", "B", "C"}，X 占据位置 2，B、C 依次后移。

引擎验证

三步验证：两参形态连续插入 5 次后 #t 应为 5 且顺序与插入顺序一致；三参形态插入位置 1 后打印全表，核对队首是否为新元素；故意写 insert(t, #t + 5, v) 观察报错信息，记住合法位置上限是 #t + 1。

举一反三

没有现成的"删除指定元素"接口时，可以先用循环找到位置再 remove；但注意 insert 与 remove 的位置参数都以 1 为起点，与 string.sub 的起点约定一致，混用 0 起点的习惯会整体错位。示例代码如下：

local function removeByValue(t, v)
    for i = 1, #t do
        if t[i] == v then
            return table.remove(t, i)
        end
    end
    return nil
end