Lua交错合并：双列交替的织布合并

【语法算法】

上一版埋了个只有短名单才露头的隐蔽报错：交错合并对短表不设防——两列名单一长一短，长表游标一路走到底，短表取值取出了空值，合并的半截列表里躺着几个空位。追到底合并的循环按长表的长度走，短表的余量没人管。修完给合并的每一拍加双表余量校验，短表走完长表接着走，谁也不取空。这篇把整改后的整套写法拆开：配置表、双列来源、交替推进、余量校验、定时器、调试按钮，一段一段照抄能跑。

一、效果演示：双列交替的织布合并

演示场两列卡片：甲列三张蓝的，乙列三张红的。点「交错合并」：两列的卡轮流飞进中间的一列——甲一乙一甲二乙二甲三乙三，织成一列交错的花布。点「拆开」：花布拆回两列，各回各家。演示里试一笔账：合并后的次序和两列的原始次序——甲列的内部次序没乱，乙列的也没乱，交错只是把两列的节拍咬合在一起。交错合并教的是咬合：两列各自完好，合并是节拍的咬合不是内容的搅拌。

flowchart TD
A[双列各备一份] --> B{两列都有余量}
B -- 是 --> C[甲出一列 乙出一列 交替]
C --> D[游标各进一格]
D --> B
B -- 否 --> E{长列还有余量}
E -- 是 --> F[长列续走到底]
E -- 否 --> G[合并完成]
F --> G

 fx-interleave

二、底层原理：一次交替推进加一次余量校验

模块的机关是一对搭档。交替推进：合并的每一拍从两列轮流取——甲一张乙一张，节拍咬合着往结果列里走，两列的内部次序各自保真。 保真才是合并的底线——底线破了合并就变成了搅拌。余量校验：每一拍取值前查两列的余量——都有的取双份、短表空了长表续走，谁的账没走完谁走完。 走到头了大家一起收工——收工的拍子也是节拍的一部分。和拼接类合并的分野在"交错是节拍的咬合不是首尾的相接"：拼接是甲列走完接乙列，次序是甲甲甲乙乙乙；交错是甲乙甲乙的织布——内容的账不合并，节拍的账重新排。

余量校验为什么在每一拍而不在开头？开头校验的版本两列必须等长，短表的一方要自己补空占位——占位符是给玩家的烂账；逐拍校验的版本两列随便多短，长列走到底短列自然收工，谁也不欠谁的占位。

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

-- @file Interleave.lua
-- 交错合并 —— 双列交替的织布合并

local Interleave = {}

local CONST = {
    COL_A         = { "甲1", "甲2", "甲3" },
    COL_B         = { "乙1", "乙2", "乙3" },

    AUTOINC_BASE  = 1167000,
}

local _merged    = {}
local _autoInc   = 0

local function GenID(prefix)
    _autoInc = _autoInc + 1
    return string.format("%s_%d", prefix or "ITL",
        CONST.AUTOINC_BASE + _autoInc)
end

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

function Interleave.Merged()
    return _merged
end

function Interleave.Clear()
    _merged = {}
end

四、核心代码：完整模块（下·交替推进与余量校验）

-- 交替推进与余量校验：谁有货谁出列
function Interleave.Merge(listA, listB)
    _merged = {}
    local ia, ib = 1, 1
    local turnA = true
    while ia <= #listA or ib <= #listB do
        if turnA and ia <= #listA then
            _merged[#_merged + 1] = listA[ia]
            ia = ia + 1
        elseif ib <= #listB then
            _merged[#_merged + 1] = listB[ib]
            ib = ib + 1
        end
        turnA = not turnA
    end
    return _merged
end

SL:ScheduleOnce(function()
    SL:BindDebugButton("交错合并", function()
        Interleave.Merge(CONST.COL_A, CONST.COL_B)
        ShowTip("织完了——甲乙交替成列")
    end)
    ShowTip("技能已加载: 交错合并 (调试按钮触发)")
end, 1.0)

function Interleave.Unload()
    _merged = {}
end

return Interleave

五、机制问答

问：两列长度不等合并后次序乱吗？
答：不乱——各列的内部次序原样保真，短列走完后长列续走到底，次序是逐列保真的。

问：合并的两列能是同一列吗？
答：能——同一列合自己就是把每个成员翻倍交错，账面合法结果也算对，虽然用处不大。

问：交错的节拍必须一一交替吗？
答：默认是——节拍的配比是参数化的口径，甲二乙一的三拍节奏改个取数规则就是，默认的一一交替最直观。

问：空列参与合并会怎样？
答：等于没合并——空列没货出列，另一列独自走完，账面等价于原列，不报错不出事。

问：合并的列要还原吗？
答：拆开就是各回各家——合并的产物是新列，两列原件从头到尾没动过，拆开的动作只是把产物扔了。

六、调参与实战怎么用

第四笔是余量的双查：逐拍校验两列余量是那场空值事故的正解——按长表走满的版本短表取空值，空值进列表后患无穷，每一拍都问一句"还有货吗"。第三笔是节拍的咬合：一一交替是最直观的织法——甲二乙一的配比留给特殊需求，默认的一一交替让玩家一眼看懂织法。第二笔是原件的保真：合并不改原件是列的体面——合并途中修改原件的版本拆开还原时对不上账，产物归产物原件归原件。第一笔是次序的保真：两列内部次序原样进合并——交错打乱的只是节拍，不是内容，次序保真是交错和搅拌的分界线。常见坑三个：短表取空值的报错事故；合并途中修改原件导致次序错乱；交错产物和拼接产物混用一个列表。

实战里交错合并是"两路轮着来"的通用件：两队轮值的排班、双资源池的轮抽、两个公告源的交替播报，全是"交替推进余量校验"的同一副骨架。组里的约定是：两列轮着出的账一律走交错合并不手写下标——下标的账交给循环，人只管看好两列的货。这篇的模块照抄能跑，改的就是 CONST 那两张表。

实战里交错合并还有一个容易踩的坑——两列的同步刷新。合并的产物是一列，但两列原件各自的更新节奏不同：一列每帧刷、一列五秒刷一次，合并的产物跟谁走？答案是跟最快的走，但慢列没更新的时候拿旧数据凑——这就引出了一个脏标记的需求：慢列更新了才重复合并，没更新就复用上次的结果。不加脏标记的版本每帧重复合并，白耗性能合并出一个一模一样的列。\n\n写完留一句给做合并系的同学：交错合并卖的是"节拍咬合内容保真"——那列甲乙甲乙的花布和两列毫发无损的原件，是把拼接升级成织布的一副梭子。