Sublime Text 不支持 Lua 断点调试，因其无内置调试器、插件 API 不暴露调试接口、构建系统不维持进程状态；实际可用方法仅有 print 和 debug.debug()（需终端启动）；真正调试应换用 ZeroBrane Studio、VS Code 或 IDEA。
Sublime Text 本身不支持 Lua 断点调试和变量查看。它没有内置调试器，也没有官方或成熟社区维护的 Lua 调试插件（如 VS Code 的 lua-debug 或 ZeroBrane Studio 那样的集成调试体验）。所谓“断点调试”，在 Sublime 中只能靠 print()、debug.traceback() 或手动插入 error("break here") 模拟，无法单步、无法停在行、无法查看作用域变量。
为什么 Sublime 不能像 VS Code 那样调试 Lua
Sublime 的插件 API（Python 3.3 嵌入式解释器）不暴露底层调试接口；所有构建系统（sublime-build）都只是调用外部命令（如 lua 或 luajit），运行完就退出，不保持进程状态。调试需要一个长期存活的调试会话、协议通信（如 DAP）、以及对栈帧/局部变量的实时访问能力——这些 Sublime 全都不提供。
常见误解来源：
- 把“添加断点”当成在代码里写
--@break注释（其实没任何作用） - 误以为安装了
LuaEnhanced或AutoLua就能调试（它们只负责语法高亮和补全） - 看到网上“sublime lua debug”教程，实际是把 Sublime 当编辑器 + 外部调试器（如
remotelua）配合使用，但配置复杂且已基本弃用
替代方案：用 print + debug.debug() 快速定位
这是 Sublime 用户最实际、最可靠的“类调试”方式，适用于绝大多数脚本级问题：
- 在可疑位置插入
print(debug.traceback())查看完整调用栈 - 用
print("x =", x, "type:", type(x))打印变量值和类型，避免隐式转换陷阱 - 在函数入口加
print(("ENTER", ...))，出口加print(("LEAVE", result))，观察执行流 - 临时启用 Lua 内置交互调试器：
debug.debug()—— 运行到此处会暂停并进入交互式子 shell（需终端环境，GUI 启动的 Sublime 不显示输入框，所以必须从命令行启动：subl your_script.lua，再在终端里操作）
注意：debug.debug() 在 Windows 下常因 stdin/stdout 绑定问题卡住，macOS/Linux 更稳定；它不能查看闭包变量，只显示当前栈帧的局部变量。
真正想断点调试？换工具，别硬扛
如果你需要：
- 点击行号设断点、F5 启动、F10 单步、F11 进入函数
- 悬浮查看变量值、右侧变量监视窗、调用栈可展开
- 条件断点、日志点、重启会话
请直接切换到以下任一方案：
-
ZeroBrane Studio：轻量、免费、开箱即用 Lua 调试（支持 Lua 5.1–5.4、Luajit），Windows/macOS/Linux 全平台，
require('mobdebug').start()一行接入 -
VS Code + Lua 插件：装
sumneko.lua+lua-debug，配置launch.json启动调试，支持智能断点、变量树、表达式求值 - JetBrains IntelliJ IDEA / LuaRider：商业方案，调试体验最接近 IDE 标准，适合大型项目
Sublime 的优势是启动快、资源省、定制强，但它不是调试器。强行在 Sublime 里折腾“断点调试”，99% 的时间花在绕过限制上，而不是解决问题本身。
最容易被忽略的一点：很多人花两小时配 Sublime 的“调试”，却没意识到 debug.debug() 只要从终端启动就能用；而真正需要图形化调试时，换工具的总耗时通常不到十分钟——包括下载、安装、跑通第一个断点。
