Sublime Text 调试 Lua 依赖构建系统而非原生支持，常见问题包括构建系统未加载、JSON 配置错误、selector 不匹配语言 scope、文件未保存、file_regex 不兼容错误格式、stdin 阻塞、PATH 环境变量缺失及 LuaEnhanced 插件未手动启用。
Sublime Text 本身不支持调试 Lua，所谓“调试”实际是靠构建系统运行 + 手动加 print 或依赖外部工具；绝大多数“调试失败”现象，本质是构建系统没跑起来，或输出路径/编码/作用域根本没对上。
为什么 Ctrl+B 按下后完全没反应
这不是 Lua 的问题，是 Sublime 根本没加载你的构建系统。JSON 配置一旦有微小错误，就会静默失效——不报错、不提示、只沉默。
- 检查
cmd字段里写的命令，是否和你在终端里敲的完全一致：如果luajit -v能输出但lua -v报错，"cmd"就必须写["luajit", "$file"]，不能硬写lua -
selector必须匹配当前文件的语言 scope：右下角显示 “Lua Enhanced”？那"selector": "source.lua.enhanced"才有效；显示 “Lua”？才用"source.lua" - 文件必须已保存为
.lua后缀，且未处于未命名临时标签页（untitled）状态——$file在未保存时为空，构建直接跳过 - 确认文件保存在
Packages/User/目录下，文件名是Lua.sublime-build（不是lua.sublime-build或build.lua）
错误信息能显示，但点击无法跳转到对应行号
核心是 file_regex 没匹配上 Lua 实际输出的错误格式。不同解释器、不同平台、甚至不同版本，报错结构都可能差一个冒号或空格。
- 标准 Lua 5.4 错误形如：
test.lua:5: attempt to call a nil value→ 正则用"^(*?):([0-9]+):?([0-9]*):? (.*)$" - Luajit 错误常带列号：
test.lua:5:12: attempt to call a nil value→ 正则得改成"^(.*?):([0-9]+):([0-9]+): (.*)$" - Windows 中文路径下，错误可能变成乱码或缺失文件名，此时正则根本匹配不到——优先把项目移到纯英文路径（如
C:/dev/）再试
脚本运行了但没输出，或卡死在 io.read()
Sublime 构建面板不提供交互式 stdin，任何阻塞等待输入的操作都会导致面板假死，看起来像“崩溃”。
-
io.read()、os.execute("pause")、require加载路径含中文，都会触发无响应或cannot open xxx: No such file or directory - 不要在脚本里写
io.read()测试；改用print("done")验证执行流即可 - 如果必须读用户输入，换终端运行：
cd $file_path && lua $file_name这种写法在 Sublime 构建系统里无效，得手动开 CMD/PowerShell 执行 - 确保
"working_dir": "$file_path"存在且可读——尤其 Windows 下中文路径 + Lua 5.4+ 默认 UTF-8 解码，容易因编码错位找不到同目录资源
Mac/Linux 上明明终端能跑，Sublime 却报 command not found
GUI 应用（包括从 Dock 或 Finder 启动的 Sublime）通常不继承 shell 的 PATH，它读的是系统级环境变量，而 brew 安装的命令默认不在其中。
- 先在终端运行
which lua，拿到真实路径（如/opt/homebrew/bin/lua） - 在构建系统中删掉
"path"字段，直接把命令写死："cmd": ["/opt/homebrew/bin/lua", "$file"] - 改完必须彻底退出 Sublime（Activity Monitor 杀掉所有
Sublime Text进程），再重启——它只在启动时读一次环境
最易被忽略的一点：LuaEnhanced 插件安装后，必须手动点击右下角语言标识，选 “Lua Enhanced”，否则 selector 匹配不上，构建系统永远不生效——这个动作没有自动触发机制。
