Sublime Text 不支持 Lua 实时调试和变量监视，需通过 print 输出至构建面板（非 Ctrl+` 控制台）；输出应结构化、带标识符，注意路径编码、缓冲及构建配置。
Sublime Text 本身不支持 Lua 变量实时查看或断点调试——它没有内置调试器，也没有变量监视面板。所谓“调试 Lua”，实际是靠手动输出、控制台日志和构建系统反馈来间接观察变量状态。真要停在某行看 local x = 5 的值？得自己加 print(x)，然后 Ctrl+B 运行看输出。
为什么 Sublime 的控制台（Ctrl+`）看不到 Lua 变量值
Sublime 的控制台（Ctrl+`）只显示 Sublime 自身 Python 插件的 print()、异常堆栈、ImportError 等；而 Lua 脚本是通过外部 lua.exe 或 luajit 进程执行的，它的标准输出（print）默认走的是构建面板（Build Results），不是 Sublime 控制台。
- 你在 Lua 文件里写
print("x =", x)，输出会出现在底部构建面板（灰色背景区域），不是Ctrl+`那个黑底白字的控制台 - 想让变量更易读，建议用
print(string.format("x = %s, type = %s", tostring(x), type(x))) - 如果构建面板没弹出，说明构建系统根本没运行成功——先查
lua -v是否可用，再确认.sublime-build文件保存在Packages/User/下且 JSON 格式合法
如何让 print 输出更接近“调试变量”效果
没有调试器，就靠结构化输出模拟。关键不是多打几行 print，而是让输出可定位、可过滤、带上下文：
- 用唯一标识符包裹变量：比如
print("=== DEBUG start ==="); print("a =", a); print("b =", b); print("=== DEBUG end ===")，方便在构建结果里 Ctrl+F 搜索 - 避免用
io.write或io.flush()——Lua 构建默认是行缓冲，print自动换行并刷新，更可靠 - 对 table 类型，别直接
print(my_table)（输出只是table: 0x...），改用require("inspect"):dump(my_table)，但需提前安装inspect.lua并放在脚本同目录或LUA_PATH路径下 - Windows 下中文路径可能导致
print输出乱码或卡死——把 .lua 文件移到纯英文路径（如C:/lua/test.lua）再试
“调试面板”其实是构建面板，它有这些隐藏行为
很多人误以为底部那个灰色面板是“调试器界面”，其实它只是命令执行的标准输出窗口。它的表现直接受构建系统配置影响：
- 如果构建系统用了
"working_dir": "$file_path"，那么print(os.getenv("PWD"))或print(debug.getinfo(1).source)才能确认当前工作目录是否符合预期 - 构建面板不支持交互式输入（
io.read()会卡住），含该调用的脚本必须注释掉才能看到后续print - 面板内容不会自动滚动到底部——新输出来了但被挡住了？按
End键或鼠标滚轮拉到底 - 输出过长时会被截断（默认最多 1000 行），可在
Preferences → Settings – User中添加："build_output_limit": 5000
真正卡住的地方，往往不是不会写 print，而是没意识到 Sublime 的 Lua 运行完全脱离编辑器进程——所有变量观测都依赖你主动“导出”，且导出通道只有 stdout 这一条。路径、编码、缓冲、构建绑定，任一环节断了，print 就静默失效。
