CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
进阶实战语法算法996引擎

Lua CSV解析:带引号转义的状态机

2026-09-27 23:30 作者:996 技术组 996引擎Lua教程传奇脚本进阶实战语法算法996引擎

【语法】
一、机制原理
抛坑提问:导出的 CSV 里有"描述, 含逗号"这种带引号的字段,简单按逗号切全乱——怎么切才对?CSV 的正解是逐字符状态机:普通态遇逗号收字段、遇引号进引号态;引号态内逗号是内容、连续两个引号是转义的单个引号、单个引号退出引号态。状态机扫完一行,字段切得分毫不差;带引号、带逗号、带转义的 CSV 全部通吃,比按逗号盲切的版本稳一个量级。
二、错误写法

lua
-- 错误:按逗号盲切,引号内逗号被误切
for seg in line:gmatch("[^,]+") do
    fields[#fields + 1] = seg
end

三、正确写法

lua
local function parseCSVLine(line)
    local fields, cur = {}, {}
    local inQuote = false
    local i = 1
    while i <= #line do
        local ch = line:sub(i, i)
        if inQuote then
            if ch == '"' then
                if line:sub(i + 1, i + 1) == '"' then
                    cur[#cur + 1] = '"'
                    i = i + 1
                else
                    inQuote = false
                end
            else
                cur[#cur + 1] = ch
            end
        else
            if ch == '"' then
                inQuote = true
            elseif ch == "," then
                fields[#fields + 1] =
                    table.concat(cur)
                cur = {}
            else
                cur[#cur + 1] = ch
            end
        end
        i = i + 1
    end
    fields[#fields + 1] = table.concat(cur)
    return fields
end

四、引擎验证
含引号逗号转义的行切出字段与预期逐项一致;普通无引号行退化为普通切分,两者共用一个解析器。
五、FAQ
问:连续两个引号算什么?
答:转义的单个引号,属于字段内容。
问:行尾没闭合引号怎么办?
答:按引号态内容收尾处理,入口可加行校验。

作者履历与出处

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

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

幂尔框架 · 实战干货 · 接口调用

LATEST ARTICLES

全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

进阶实战游戏功能

Lua+next遍历:next的底层遍历本质

【语法算法】 next 的遍历本质就这一行: 传入上一个键,返回下一个键值对——不传上一个键就从第一个开始——next 是 …

2026-09-29 15:16 996 技术组
进阶实战游戏功能

Lua+多重返回值:函数返回值的截取与传递本质

【语法算法】 返回值的截取本质就这一行: 函数返回三个值,左侧三个变量各接一个——多余的返回值被丢弃,不足的补 nil——多…

2026-09-29 15:16 996 技术组
进阶实战游戏功能

Lua+collectgarbage:GC的手动触发与分步本质

【语法算法】 collectgarbage 的分步回收就这一行: "step" 模式让 GC 执行一步增量回收——参数 20…

2026-09-29 15:16 996 技术组
进阶实战游戏功能

Lua+string.gmatch:迭代匹配的遍历本质

【语法算法】 gmatch 的迭代本质就这一行: gmatch 返回一个迭代函数——每次调用返回下一个匹配——遍历完返回 n…

2026-09-29 15:16 996 技术组
进阶实战游戏功能

Lua+xpcall:错误处理函数的传入本质

【语法算法】 xpcall 的错误处理函数就这一行: xpcall 和 pcall 的本质区别就一个:xpcall 可以传入…

2026-09-29 15:16 996 技术组
进阶实战游戏功能

Lua+元方法__index为函数:代理转发与懒加载的本质

【语法算法】 元方法 __index 设为函数的本质就这一行: 读取表中不存在的键时,Lua 调用 __index 函数——…

2026-09-29 15:16 996 技术组