【入门夯实】__add算术元方法：表参与加法的回退机制

学员常见误区

学员尝试让两张表直接相加实现数值合并：local total = tableA + tableB，直接报 attempt to perform arithmetic on a table value——表默认不支持算术运算，参与加减需要元表提供 __add 元方法。没配元方法的表参与任何算术都会报错，错误行指向算术表达式本身。错误场景：

lua

local a = { gold = 100 }
local b = { gold = 200 }
local total = a + b

表加表直接报错，没有元方法回退。

正确姿势

setmetatable 挂上 __add 元方法，定义表加表的行为。规范写法。示例代码如下：

lua

local mt = {
    __add = function(x, y)
        return { gold = x.gold + y.gold }
    end,
}
local a = setmetatable({ gold = 100 }, mt)
local b = setmetatable({ gold = 200 }, mt)
local total = a + b
print(total.gold)

a 与 b 共用同一张元表，加法回退到 __add 定义的合并逻辑，返回新的合并表。示例代码如下：

lua

local mt2 = {
    __sub = function(x, y)
        return { gold = x.gold - y.gold }
    end,
}

__sub 对应减法、__mul 对应乘法，算术族元方法一一对应。

引擎验证

三步验证：配元表后 a + b 返回 gold 为 300 的表；去掉元表复现 attempt to perform arithmetic 报错；混用带元表与不带元表的表相加，验证回退只在双方都有元方法语义时才成立（右操作数元表也可提供 __add）。

举一反三

算术元方法同样支持表与数字混算：第二个参数可能是数字，元方法内要做类型分支。示例代码如下：

lua

__add = function(x, y)
    if type(x) == "number" then
        return { gold = y.gold + x }
    end
    return { gold = x.gold + y }
end

作者履历与出处

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。

📖 接口说明API × 3

setmetatable setmetatable(t, mt, 标准库, 设置元表，Lua 面向对象类系统的基石。, t 本身)

标准库

设置元表，Lua 面向对象类系统的基石。

t 本身

返回：见说明

collectgarbage

collectgarbage("count", 标准库, 统计或触发 Lua GC，内存排查的测量起点。, count 模式返回当前 Lua 内存（KB）)

"count"

标准库

统计或触发 Lua GC，内存排查的测量起点。

count 模式返回当前 Lua 内存（KB）

返回：见说明

string.unpack

string.unpack(fmt, s [, init], 标准库, 按格式解二进制串，长度前缀协议拆包的核心函数（Lua 5.3+）。, 值, 下一个位置)

fmt

s [

init]

标准库

按格式解二进制串，长度前缀协议拆包的核心函数（Lua 5.3+）。

值

下一个位置

返回：见说明

← 返回文章地图返回研学路径

学员常见误区

正确姿势

引擎验证

举一反三

最新技术文章 · 实战干货

【高级技巧】Lua敏感词扫描：沙巴克喊话的词表命中统计

【入门夯实】Lua背包容量：裁决之杖入包前的空位校验

【入门夯实】Lua两段判定：祖玛教主掉落的先稀有度再物品

【高级技巧】Lua合击窗口：烈火剑法双人连招的时间容差

【策划架构】Lua登出保存：组队结算数据的离线落库钩子

【入门夯实】Lua堆叠合并：仓库同物叠加的计数归并