Lua脏检查：改了才刷新 没改就跳过

【语法算法】

隐蔽报错引入：一个很隐蔽的报错——界面数据明明改了，面板却偶尔不刷新。修改逻辑和刷新逻辑分属两个模块，改数据的一方不知道要通知界面，界面按固定节奏轮询又刚好错过。脏检查的方案是把"改了"落成标记：修改时盖戳，刷新时只挑带戳的处理，处理完撕戳。这篇把脏检查整套写法拆开：盖戳写入、等值闸门、按戳刷新、卸载归零，一段一段照抄能跑。

一、效果演示

演示场两块数据面板，各显示一组数值。点「改A字段」或「改B字段」：被改的格子盖上一枚橙色脏标记。点「清除脏标记」：所有标记归零，面板恢复平静。标记数量实时显示，脏的格子橙色、净的格子灰色。

flowchart TD
A[写入数据] --> B{和旧值一样吗}
B -- 是 --> C[直接忽略]
B -- 否 --> D[更新并盖脏标记]
D --> E[刷新时机到]
C --> E
E --> F[扫脏标记表]
F --> G{还有带戳的吗}
G -- 是 --> H[重绘这条并撕戳]
H --> F
G -- 否 --> I[本轮结束]

 fx-dirtycheck

二、底层原理

脏检查的机关是写入和刷新的解耦——写入方只管改数据和盖戳，刷新方只管挑带戳的处理，两边不用认识对方。省的真相在"没改的多数"：一百项数据一次只改两三项，全量刷新白画九十七项，按戳刷新只画带戳的两三项，开销跟着变化量走而不是跟着总量走。
写入口的一致值判断是第一道闸——新值和旧值相同直接忽略，戳都不盖，把无意义的刷新掐死在源头。粒度是双刃剑：戳到字段级最省但管理开销大，戳到面板级省心但刷新面大，工程上按刷新代价的差距定粒度——贵的面板细到字段，便宜的面板整块一戳。

这套机制的代码量不到八十行，难的不是盖戳，而是把"谁负责撕戳"钉死——两头撕戳或者漏撕都会让刷新节奏乱套。

撕戳的时机要和刷新节奏绑死——刷新一轮的开始先扫戳、逐条重绘、重绘完立刻撕戳，三步一气呵成。最怕的是重绘和撕戳之间隔着一次异步回调，回调里再改同一格数据，新盖的戳被旧的一把撕掉，这一格就再也不会刷新了。所以撕戳只撕"重绘开始那一刻读到的快照"，重绘途中新盖的戳留到下一轮——顺序想清楚，节奏才稳。

三、核心代码：完整模块（上·骨架）

-- @file DirtyCheck.lua
-- 脏检查 —— 改了才刷新 没改就跳过

local DirtyCheck = {}

local _data      = {}
local _dirty     = {}

local function ShowTip(msg)
    if msg and msg ~= "" then SL:ShowSystemTips(msg) end
end

function DirtyCheck.Set(key, value)
    if _data[key] == value then return end
    _data[key] = value
    _dirty[key] = true
end

function DirtyCheck.Get(key)
    return _data[key]
end

function DirtyCheck.IsDirty(key)
    return _dirty[key] == true
end

四、核心代码：完整模块（下·推进与卸载）

-- 撕掉单个脏标记
function DirtyCheck.ClearDirty(key)
    _dirty[key] = nil
end

-- 撕掉全部脏标记
function DirtyCheck.ClearAll()
    _dirty = {}
end

SL:ScheduleOnce(function()
    DirtyCheck.Set("hp", 100)
    DirtyCheck.Set("mp", 50)
    ShowTip("技能已加载: 脏检查")
end, 1.0)

function DirtyCheck.Unload()
    _data = {}
    _dirty = {}
end

return DirtyCheck

五、机制问答

问：脏标记什么时候撕？
答：刷新完成的当拍——带戳重绘完立即撕，没撕的标记下一轮会白白重绘一次。

问：写入口的等值判断有什么用？
答：掐死无效刷新——新值旧值一样连戳都不盖，后续全链路直接省掉。

问：粒度怎么定？
答：按刷新代价分——重绘贵的面板戳到字段级，便宜的面板整块一戳，别为省管理费背上大刷新。

问：多模块同时改同一份数据行不行？
答：行——戳是幂等的，改十次也只盖一枚，刷新方只认脏不脏，不认改了几次。

问：和每帧全量刷新比省在哪？
答：开销跟变化量走——变化越少省得越多，静态界面整帧零重绘。

六、调参与实战怎么用

参数层面可调的是刷新节奏和粒度——刷新不必每拍都跑，按界面的容忍度定周期，两三拍一轮肉眼无感。实战里这类机制是界面层的标配：血条、背包、任务列表、行会信息，一切数据在别处改、界面在这里画的位置都该有它。常见坑两个：卸载时脏表没清空，重载后带着旧戳把整块界面白刷一遍；异步写入绕过写入口直接改底表，戳永远盖不上——所有写入必须走同一个门。

补充一个设计层面的思考——这类机制的核心难点不在于代码怎么写，而在于"什么时候触发、触发后做什么、做完了怎么收场"这三个问题的答案。答案清楚了，代码只是把答案翻译成脚本的过程；答案含糊，写出来的东西改来改去都在原地打转。动手前先把这三个问题各用一句话答出来，答不出的那个就是设计缺口，先补设计再动手。

补充一个维护层面的思考——所有的状态变量都收在模块的闭包里，不摆到全局表。全局表的变量在热重载时会残留旧值，闭包的变量每次加载都是新的，这层隔离是热重载环境里防事故的第一道墙。卸载入口要把定时器、连接、标记一揽子清干净，清不干净的下场就是旧事故原样重演。这篇的模块照抄能跑，改的就是参数表。

补充一个工程层面的思考——模块的可测试性和耦合度成反比。耦合越低越能单独验证，越高越要整套环境才能跑起来。降耦合的通用手法是依赖注入：框架接口通过参数传进来，而不是在模块里直接调死，验证的时候传一组假接口就能脱离框架独立运行。平时多花一分钟做注入，排查的时候省下的是一整晚。

写完留一句给做界面系的同学：改了才画，没改就歇——一枚小小的脏标记，省下的是整帧的白画。