【高级技巧】元表__tostring的调试输出定制：对象自描述

底层原理

tostring 与 print 对 table 的默认输出是表地址（table: 0x...），日志里一堆地址毫无信息量。Lua 5.1 的 tostring 转换会查元表的 __tostring 元方法（F:\底层文件 的 lbaselib.c tostring 实现路径），存在则以其返回值替代默认格式。战斗对象挂上 __tostring 后，print 一行输出全部关键字段，复现一次 bug 的定位时间从半小时级降到分钟级。元方法只在 tostring 调用时触发，平时零开销。

高级封装

给战斗单位包装对象挂自描述元表：输出名字、等级、血量、怒气四个关键字段。示例代码如下：

local function wrapUnit(name, level, hp, rage)
    local u = { name = name, level = level, hp = hp, rage = rage }
    return setmetatable(u, {
        __tostring = function(self)
            return string.format("[单位 %s 等级%d 血量%d 怒气%d]",
                self.name, self.level, self.hp, self.rage)
        end
    })
end
local boss = wrapUnit("祖玛教主", 60, 320000, 100)
print(tostring(boss))

日志输出：[单位 祖玛教主 等级60 血量320000 怒气100]，四个字段一次看全。示例代码如下：

local function dumpActor(actorName)
    local actor = getplayerbyname(actorName)
    local info = string.format("在线=%s 名字=%s",
        tostring(actor ~= nil), actorName)
    print(info)
end

getplayerbyname 对离线名字返回 nil，dumpActor 把在线状态与名字并排输出，排查"玩家声称在线"类工单时一行定位。

性能对比

调试同一个战斗对象：无 __tostring 时日志只有地址，需要在五个位置各写一行字段拼接代码、重新触发场景复现，一次定位平均 30 分钟；挂 __tostring 后任何 print 位置一行输出四字段，定位平均 5 分钟。运行时开销方面：__tostring 仅在 tostring 调用时执行一次拼接，约 0.003 毫秒，非调试路径不触发；对比每处手写 5 行字段打印，代码维护点从 5 处收敛到 1 处。

适用边界

三个不适用场景：一是生产环境的热路径（每帧调用的战斗结算）里不要 print 带 __tostring 的大表，拼接开销会随调用频次放大；二是字段超过 15 个的大对象，一行自描述放不下还容易超日志截断长度，应拆分核心字段与非核心字段两张元表；三是需要序列化落库的对象别依赖 __tostring，它输出的是展示文本不是可解析格式，落库要走表遍历序列化。