Sublime Text 无法原生调试 Lua 是因缺少调试协议支持，需用 mobdebug + ZeroBrane Studio：将 mobdebug.lua 放入 ./libs/ 并调用 start()，ZBS 后台监听 8172 端口，Sublime 负责编辑，ZBS 处理断点与变量查看。
Sublime Text 本身不内置 Lua 调试器，lua 解释器也默认不带调试协议支持，直接按 Ctrl+B 只能运行、无法断点/单步/查看变量——这不是你配置错了，是工具链缺关键一环。
为什么 lua Build System 不能算“调试”
Sublime Text 的 Build System 本质是调用命令行执行 lua 或 luajit，它只捕获 stdout/stderr，不接入调试器协议（如 DBGp、LuaSocket-based debug server）。所以：
- 报错只能看到最后一行 traceback，看不到调用栈完整路径或局部变量
- 无法在某行暂停、检查
table内容、修改变量值后再继续 -
print是唯一“调试手段”，但改完要删、漏删会污染生产逻辑
真正可用的调试方案：mobdebug + ZeroBrane Studio 后端
别折腾 Sublime 自研调试插件。最稳路径是复用成熟 Lua 调试生态：mobdebug（轻量、兼容 Lua 5.1–5.4 / LuaJIT）配合 ZeroBrane Studio 的调试服务，Sublime 只负责编辑和触发断点。操作要点：
- 把
mobdebug.lua放进项目./libs/目录，代码开头加require("libs.mobdebug").start() - ZeroBrane Studio 不用打开 UI，后台启动调试服务：
zbstudio -debugger（macOS/Linux）或双击ZBS_Debugger.exe（Windows） - Sublime 中运行脚本时，
mobdebug会自动连接到本地127.0.0.1:8172，断点停在 ZBS 窗口里 —— 你在 Sublime 写，ZBS 负责停、看、步 - 关键技巧：ZBS 的
Debug → Break on error打开后，未捕获异常会自动中断，比pcall包一层更省事
lua Build System 配置避坑：路径、版本、错误定位
即使不调试，日常运行也常卡在环境问题上。Build System 文件（如 Lua.sublime-build）必须显式声明解释器路径和参数：
- 不要用
"cmd": ["lua", "$file"]—— macOS 上可能调到系统自带的 Lua 5.2，而你的项目依赖 5.4；Windows 可能根本找不到lua.exe - 正确写法（macOS/Linux）：
"cmd": ["/usr/local/bin/lua-5.4", "$file"]，路径用which lua-5.4确认 - Windows 必须用正斜杠或双反斜杠：
"cmd": ["C:/Program Files/Lua/5.4/lua.exe", "$file"]，单反斜杠会被 Sublime 当转义符吃掉 - 加
"shell": false，否则 Windows 下路径空格会导致启动失败（比如Program Files） - 错误行号不准？在
cmd末尾加-e "package.loaded['mobdebug']=nil"清掉缓存，避免旧调试状态干扰
快速验证是否真“可调试”：三行代码测通路
别等写完 500 行再试。新建 test.lua，粘贴这三行：
require("mobdebug").start()
print("break here")
local x = {a=1, b=2}
print(x.a)
运行后立刻切到 ZeroBrane Studio —— 如果左下角显示 Connected 且第二行高亮为断点，说明链路通了。如果卡住不动，90% 是防火墙拦了 8172 端口，或 mobdebug.start() 被放在 if false then 块里没执行。
真正的难点从来不在“怎么加断点”，而在确认 lua 进程是否真的连上了调试服务、以及 Sublime 和 ZBS 之间谁在等谁。路径、端口、解释器版本，这三个点漏查一个，就会陷入“点了运行但毫无反应”的死循环。
