调试全靠裸 print：变量随手一打，完事忘删，上线后控制台每秒刷几十行"走到这里了"——真正重要的错误信息被调试噪音淹没。print 无级别、无前缀、无清理机制，是调试输出的三大乱源。错误场景：
local function settleBad(actor)
actor = getplayerbyname(actor)
print("进入结算")
print(actor)
print("结算完成")
end
三行 print 没有任何前缀与分级，控制台里与系统日志混作一团。
调试输出分三级并带前缀：DEBUG 级只在调试期开启（上线前全局关闭）、INFO 级记录关键节点、ERROR 级必带上下文。示例代码如下：
local DEBUG_ON = false
local function dbg(line)
if DEBUG_ON then
print("[DEBUG] " .. line)
end
end
local function logError(line)
print("[ERROR] " .. line)
end
local function settleGood(actor, amount)
actor = getplayerbyname(actor)
dbg("settle 入口，amount=" .. amount)
if amount <= 0 then
logError("结算金额非法：" .. amount)
return
end
giveitem(actor, "金条", math.max(1, math.floor(amount / 10000)))
sendmsg(actor, 1, "结算完成。")
end
本篇的新技术点是"DEBUG_ON 总开关"：调试期打开全量输出，上线只改一个布尔值，DEBUG 级全部静默，ERROR 级永久保留——分级让"清理调试代码"变成"翻一个开关"。
三步验证：DEBUG_ON 为 true 时触发结算，控制台应同时出现 DEBUG 与关键节点输出；置 false 后重载，只剩 ERROR 级可见；构造金额为 0 的非法结算，确认 ERROR 级在任何模式下都打印。
ERROR 级日志要带定位信息：模块名加函数名写进前缀，控制台里一眼知道错误来自哪个模块，不用全局搜索。示例代码如下：
local function logModuleError(moduleName, fnName, line)
print("[ERROR][" .. moduleName .. "." .. fnName .. "] " .. line)
end
全站技术干货持续更新：996 引擎 / Lua 实战帖，语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
设计初衷 安全区村庄只是传送与摆摊的功能集散地：NPC 站桩、玩家路过、两不相干。村庄共生设计：让村庄与玩家互相需要——玩家…
设计初衷 高战玩家的经验只在小圈子里口口相传，新手想学连门路都没有；师徒系统绑定太重，轻量的武学传授没有载体。玩家武馆设计：…
设计初衷 服务器的日常是可预期的循环：刷怪、活动、攻城——缺乏全员共同面对的异常时刻；既有的世界事件又只是打怪换皮。天灾事件…
底层原理 给地图据点分阵营、要求相邻据点不同阵营——这是图的染色问题。二分染色是最简单的情形：从任一点出发做 BFS 逐层染…
底层原理 常规表一键一值；"一个玩家持有多件装备""一个行会包含多名成员"是一对多关系——多重映射（multimap）：每个…
业务场景 沙巴克战后残血只能灌药慢慢回；NPC 医师的一次性治疗要么免费无成本、要么收费高到劝退。帮会医师封装：帮会驻地常驻…