Sublime Text 不支持 Lua 单步调试，仅能通过 print 打点或控制台查错；Debugger 插件无效因 Lua 进程与 Sublime 的 Python 环境完全隔离；推荐用 lua-language-server + SublimeLSP 实现静态分析，真需单步应换 ZeroBrane Studio 或 VS Code。
Sublime Text 本身不支持 Lua 单步调试
它没有内置断点、步进（Step Over/Into）、变量监视或调用栈面板——这些功能只存在于专用 IDE（如 ZeroBrane Studio）或 VS Code + lua-debug 插件中。Sublime 的构建系统只是调用 lua 或 luajit 命令跑完脚本，属于“运行即结束”模式，无法暂停、无法查栈、无法看局部变量。
所谓“调试”，在 Sublime 里实际只有两种可行路径：
- 靠
print()/io.stderr:write()手动打点，配合 Ctrl+B 快速重跑观察输出 - 打开控制台（
Ctrl+`），看插件加载失败、JSON 解析错误、路径编码异常等底层问题
为什么 Debugger 插件对 Lua 无效
Sublime 的插件运行在嵌入式 Python 解释器（Py3.8+）中，而 Lua 脚本是通过构建系统启动独立进程执行的。两者完全隔离：
- 你加的断点（比如在代码里写
debug.debug()）不会被 Sublime 捕获，因为debug库默认不启用，且 Sublime 没有接入lua-gdb或remotedebug协议 - 任何声称“Sublime + Lua 调试插件”的方案，基本都依赖外部工具（如
lua-language-server）提供语义分析，但依然无法实现单步——它只做 hover 提示、跳转定义、错误标记 - 如果你看到某教程说“装 XX 插件就能 F5 调试 Lua”，大概率混淆了 Sublime 和 VS Code 的能力边界
替代方案：用 lua-language-server + SublimeLSP 实现基础诊断
虽然不能单步，但可以逼近 IDE 级别的静态分析体验，包括调用栈提示（函数跳转链）、参数提示、未定义变量标红等：
- 先确保系统已安装
lua-language-server（不是lua，而是 LSP 服务端），推荐用luarocks install lua-language-server或从 GitHub releases 下载二进制 - 在 Sublime 中通过 Package Control 安装
SublimeLSP，再配置Lua.sublime-settings，关键字段必须包含：{ "enabled": true, "selector": "source.lua", "command": ["lua-language-server"], "initializationOptions": { "diagnostics": {"enable": true} } } - 重启 Sublime 后，把光标停在函数调用处按
F12，能跳转到定义；悬停显示参数签名；保存时自动触发luacheck类似检查 - 注意：它不提供运行时调用栈（比如某行崩溃后看不到“谁调用了这个函数”），只提供静态可推导的调用关系
真正需要单步时该怎么做
别硬扛。Lua 单步调试不是 Sublime 的设计目标，强行折腾只会浪费时间：
- 轻量脚本 → 直接改用
ZeroBrane Studio（Windows/macOS/Linux 全平台，开箱即用，支持远程调试、变量监视、实时控制台） - 游戏开发（Love2D/Roblox）→ 用对应引擎自带调试器，或 VS Code +
lua-debug配合love.exe --console - 嵌入式场景（Nginx/Redis）→ 在 C 层加
printf或用gdbattach 到宿主进程，Sublime 只负责编辑 .lua 文件 - 如果必须在 Sublime 编辑 + 外部调试，建议把构建系统改成：
"cmd": ["lua", "-i", "$file"]，这样脚本执行完会进入交互模式，可手动调用函数、检查变量值
最常被忽略的一点：很多人花半天配“调试插件”，却没意识到自己真正需要的只是更好的错误定位——而 file_regex 正确匹配报错格式（比如 "^(*?):([0-9]+):?([0-9]*):? (.*)$"），配合 Ctrl+Click 错误行，已经能解决 80% 的日常问题。
