【入门夯实】中文注释的编码错位：文件编码与乱码排查

学员常见误区

脚本文件是 UTF-8，编辑器却按 GBK 保存——中文注释变成乱码；更隐蔽的是乱码字节里恰好出现引号或括号的字节序列，把注释或字符串提前终结，语法报错指向毫不相干的行。学员逐行排查语法，永远找不到病灶在编码。错误场景：

-- 配置：祖玛教主掉落（此行被错误编码保存后成乱码）
local rate = 50
print(rate)

乱码字节若含引号序列，rate 那行会被吞进注释——报错行与病灶行隔着好几行。

正确姿势

全项目统一 UTF-8；乱码排查用纯 ASCII 标记行做二分定位。规范写法。示例代码如下：

-- [ENC-A] ascii marker 1
local rate = 50
-- [ENC-B] ascii marker 2
print(rate)

报错若出现在标记 B 之前、标记 A 之后，乱码就夹在两标记之间——再加标记继续二分，三五个标记锁定乱码区间。

引擎验证

三步验证：用错误编码保存一段带中文注释的脚本再加载，复现乱码与语法错位；插入 ASCII 标记行做二分定位，圈出乱码注入区间；统一转回 UTF-8 后加载恢复正常，标记行删除。

举一反三

同源问题是变量命名：部分引擎版本不接受非 ASCII 标识符，命名保持英文、中文只留在注释与文案。示例代码如下：

local rate = 50  -- [EN] boss drop rate / 祖玛教主掉率
print(rate)

双语注释头保证任何编码下注释都可读——编码问题的爆炸半径缩到最小。