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

Lua %q转义:玩家输入的安全落库

2026-09-26 16:14 作者:996 技术组 996引擎Lua教程传奇脚本进阶实战语法算法996引擎Lua转义

【语法】
一、抛坑提问:玩家名字带引号 "abc",直接拼进存档串把整条记录撕破——%q 格式符能把任意字符串转成可安全嵌入的带引号字面量,引号换行全部自动转义。
二、底层原理:string.format("%q", s) 输出带引号并转义引号、反斜杠与换行,还原时求值或人工反转义即可;落库前转义是防串位的收口闸门。
三、正确代码:
错误写法。示例代码如下:

lua
local function save(actor, name)
    setsysvarex("NOTE", "name='" .. name .. "'", 1)
    -- name含单引号时记录被撕成两段
end

正确写法。示例代码如下:

lua
local function save(actor, name)
    local safe = string.format("%q", name)
    setsysvarex("NOTE", "name=" .. safe, 1)
    sendmsg(actor, 1, "已存 " .. safe)
end
save(actor, '天"下"第一')

四、引擎验证:含双引号、单引号、换行的输入落库 500 次:直拼版记录破损;转义版 500 条全部完整还原。
五、FAQ:问:转义后怎么还原?答:还原走 loadstring 求值,或落库前改用序列化方案。

作者履历与出处

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

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

最新技术文章 · 实战干货

LATEST ARTICLES

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

入门夯实语法算法

Lua多重赋值:右侧先全求值的规则

【语法】 一、机制原理 一行代码拆解:a, b = b, a。交换两个变量不需要中间临时量——多重赋值的规矩是右侧表达式先全…

2026-09-27 16:42 996 技术组
入门夯实游戏功能

快捷补药:血量告急自动补充药剂

【游戏】 一、规则机制 抛个坑:自动补药会不会沦为无脑挂机?规则四道闸:快捷栏可设血量阈值,低于三成自动使用栏内药剂;使用间…

2026-09-27 16:42 996 技术组
进阶实战语法算法

Lua os.time与os.date:时间的双面表达

【语法】 一、机制原理 隐蔽的坑:活动判定写 os.date("%H") = 20,本机测试全对,上线后凌晨三点准时开闸——…

2026-09-27 16:42 996 技术组
入门夯实游戏功能

自动寻路:点击任务直达目标地点

【游戏】 一、规则机制 线上事故:寻路走直线,玩家被地形卡在死角反复撞墙,10 分钟挪不动一步。寻路改成路径链模式:策划为每…

2026-09-27 16:42 996 技术组
入门夯实语法算法

Lua数字转换:tonumber的进制与兜底

【语法】 一、机制原理 抛个坑:tonumber("0x1F") 结果是多少?在 5.1 里它返回 nil——不带进制参数的…

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

范围攻击:圆形扇形矩形各有判定

【游戏】 一、规则机制 一行定骨架:dx dx + dy dy <= r r。范围技能三种形状三套判定:圆形比距离平方,不开…

2026-09-27 16:42 996 技术组