
Sublime Text 本身不支持可视化调试(比如断点、变量监视、单步执行),所谓“可视化调试工作流”只能靠外部工具链 + 构建系统 + 输出增强来模拟,核心是让错误更易定位、状态更易观察、上下文更可控——不是真有调试器,而是用最轻量的方式逼近调试体验。
为什么不能直接加断点或看变量值
Sublime 的构建系统本质是调 shell 命令,它没有调试协议支持(如 DAP),也不嵌入 Lua 调试器。你看到的“输出面板”只是 stdout/stderr 的只读快照,io.read() 会卡死,print() 是唯一可靠的状态出口。任何声称“Sublime 内置 Lua 调试”的教程,要么混淆了插件功能(如 Lua Enhanced 只做高亮跳转),要么把外部工具(如 ZeroBrane Studio)包装成 Sublime 插件误导用户。
用 print + file_regex 实现“伪断点跳转”
在关键位置插入带文件/行号标记的 print,再配对 file_regex,点击输出就能跳转到对应代码行——这是最稳定、零依赖的“可视化锚点”方案。
-
print(("DEBUG %s:%d val=%s"):format(...debug.getinfo(2, "S").source:sub(2), ...debug.getinfo(2, "l").currentline, tostring(x)))—— 手动拼路径+行号,兼容所有 Lua 版本 - 构建系统中
file_regex必须匹配该格式,例如:"^DEBUG (.*?):([0-9]+) val=(.*)$" - 不要用
debug.traceback()直接输出:它含多行且无固定结构,file_regex无法稳定捕获 - 如果用 LuaJIT,
debug.getinfo(2, "S")的source可能是@main.lua,正则需适配"^DEBUG @(.+?):([0-9]+)"
用 working_dir + 相对路径避免资源加载失败
游戏脚本或 Love2D 项目常因工作目录不对导致 require 找不到模块、io.open("assets/icon.png") 报 cannot open。这不是编码错误,是构建时 working_dir 没设对。
- 必须显式写
"working_dir": "$file_path",不能省略;"shell_cmd": "cd $file_path && lua $file"在 Sublime 中无效 - 若项目结构是
game/main.lua+game/assets/,则$file_path解析为game/,io.open("assets/icon.png")才能成功 - Windows 下中文路径仍会崩:哪怕
$file_path是C:/我的项目/,Lua 5.4 也会因 GBK 路径解析失败而报No such file or directory—— 唯一解是全英文路径
用 variants 区分运行、检查、格式化三类操作
一个 .sublime-build 文件可通过 variants 字段定义多个命令,按 Ctrl+Shift+B 弹出菜单选择,避免来回切构建系统。
{
"cmd": ["lua", "-c", "print('OK')"],
"selector": "source.lua.enhanced",
"variants": [
{
"name": "Run",
"cmd": ["lua", "$file"]
},
{
"name": "Check (luacheck)",
"cmd": ["luacheck", "$file"],
"file_regex": "^(.+?):([0-9]+):([0-9]+): (.*)$"
},
{
"name": "Format (stylua)",
"cmd": ["stylua", "$file"],
"shell": true
}
]
}
注意:luacheck 和 stylua 需提前装好(luarocks install luacheck、curl -L https://github.com/JohnnyMorganz/StyLua/releases/download/v0.22.0/stylua-linux-amd64 -o /usr/local/bin/stylua),且路径必须在 Sublime 启动时的 PATH 中(macOS GUI 启动时可能读不到 ~/.zshrc,建议写绝对路径如 "/opt/homebrew/bin/luacheck")。
真正难的从来不是配置几行 JSON,而是接受 Sublime 的边界:它不提供调试器,也不改写 Lua 运行时。所有“可视化”都建立在你对 print 输出结构、file_regex 捕获逻辑、以及路径编码规则的精确控制上——漏掉任意一环,点击就跳错行,输出就乱码,资源就加载失败。











