【入门夯实】%q转义占位符：安全引用字符串的格式化

学员常见误区

把角色名存进存档文件时手工拼引号：存档内容写成 name = "甲"，玩家名里带引号或换行时，存档读回直接解析炸。手写转义要处理引号、反斜杠、换行三类字符，漏一类就是一个坑。string.format 的 %q 占位符专门解决这个问题：输出带引号且已完整转义的可还原字面量。错误场景：

local save = 'name = "' .. name .. '"'

name 为 带"引号"的玩家 时，存档语法损坏。

正确姿势

存档字符串一律 %q 格式化，读回用 load 还原。规范写法。示例代码如下：

local name = '带"引号"的\n玩家'
local save = string.format("name = %q", name)
print(save)
local ok, restored = pcall(load("return " .. save))
print(restored == name)

%q 输出的串无论原文含引号、换行还是控制字符，load 回读后与原值一致——存取往返无损。

引擎验证

三步验证：普通名与含引号换行的名各存一份，load 回读全部与原值相等；手工拼引号的写法对含引号名字复现解析错误；对数字用 %q 观察输出形式（可还原的数字字面量）。

举一反三

%q 对布尔与数字同样输出可还原形式，混合存档可以逐项 %q 后拼接，读回统一 load。示例代码如下：

local mixed = string.format("a = %q; b = %q", tostring(true), tostring(42))