【入门夯实】多行注释：--[[ ]]的屏蔽与嵌套陷阱

学员常见误区

用 --[[ ]] 多行注释屏蔽代码时，被注释的内容里自带 ]]（如 t[a[1]] 这类嵌套索引）——注释在遇到第一个 ]] 时提前终止，后面的"注释"变成活代码被执行，报出莫名其妙的错误。错误场景：

--[[
local idx = t[a[1]]
print("这行会被执行")
]]
print("正常执行")

a[1]] 里的 ]] 把注释关掉了，"这行会被执行"真的执行了——屏蔽失败且报错位置远离病灶。

正确姿势

被注释内容可能含 ]] 时，用带等号层级的长括号定界；或直接逐行 -- 注释。规范写法。示例代码如下：

--[==[
local idx = t[a[1]]
print("这行不会被执行")
]==]
print("正常执行")

[==[ 与 ]==] 的层级等号让边界不歧义，内容里的 ]] 不再误伤。

引擎验证

三步验证：写含 a[1]] 的普通 --[[ 注释，复现提前终止（中间的 print 抢先执行）；换成 [==[ ]==] 后整块静默；再用长括号注释快速开关一段烈火剑法的调试输出，验证开关动作干净利落。

举一反三

注释也常用于临时禁用逻辑，长期禁用应删除而非收藏。示例代码如下：

-- 双倍经验活动已于 20260901 下线，改走日常经验
-- exp = exp * 2
exp = exp + 10
print(exp)

保留一行说明、删掉死代码——注释解释"为什么没有这段"，而不是替版本管理收藏尸体。