【Lua实战】多重返回值：引擎接口的批量数据接收

实战应用：用在哪里

引擎的接口常常一次吐出多个数据：属性的三项、坐标的 XY、查找的结果与位置。多重返回值的接收、截断与透传是 Lua 的基本功，接错了参数顺序，数据就静默地串了位。

返回值的接收

---多重返回值的完整接收
local function getBase(actor)
    -- 模拟一次返回多项的查询
    return "血饮狂刀", 45, "warrior"
end

local name, level, job = getBase(actor)
print(name, level, job)

---只取前两项：多余的自动丢弃
local name2, level2 = getBase(actor)

---占位：中间的项用局部变量承接
local n3, _, job3 = getBase(actor)

多重返回值按位置对应接收：变量少则多余的返回值丢弃，变量多则不足的补 nil。中间不关心的项用下划线变量的惯例占位——占位是约定不是语法，可读性靠团队的默契。返回值可以直接透传：return f(x) 把 f 的全部返回值原样带出，包装函数的透传省去逐个解包再打包的繁琐。

解包与转发

---表转多重返回：unpack 的配合
local stats = { 1250, 800, 300 }
local atk, def, hp = table.unpack(stats)
print(atk, def, hp)          -- 1250, 800, 300

---指定区间：只解包一部分
local atk2 = table.unpack(stats, 1, 1)
print(atk2)                  -- 1250

---函数调用的参数展开
local function add(a, b, c)
    return a + b + c
end
print(add(table.unpack(stats)))   -- 2350

table.unpack 把数组表摊开成多重返回值，与打包的方向互逆：{ f() } 把多重返回值收进表、table.unpack(t) 把表摊开传参。区间的解包（第二第三参数）只摊指定范围，长表的部分解包避免全量展开的开销。陷阱区在 nil 的尾巴：返回值序列中间的 nil 会让 { f() } 的打包提前截断——可靠的做法是让接口用「数量加数组」的模式返回，Lua 的 select('#') 可数清包含 nil 在内的全部参数。

验证与监控

多返回值的单测覆盖：全量接收、部分接收、中间占位、unpack 的区间四种形态；接口的返回值结构进文档，字段的数量与顺序是契约。

踩坑记录

接收的变量顺序曾经与返回顺序颠倒，攻击力接成了等级，顺序的对照表进接口文档。unpack 曾经没传区间，含 nil 的表摊开后半段丢失，显式传边界。多返回值直接进字符串拼接，只有第一个值参与拼接，先收齐再拼的写法替代。

上线要点

引擎接口的返回值清单进接口文档：数量、顺序、类型三要素。包装函数的透传用直接 return 的形态，享受尾调用的优化。多返回值与表的选型：固定的短数据用多返回值，可变长的集合用表。