Sublime Text 不支持原生 Lua 调试，仅能通过构建系统运行脚本；Ctrl+B 失效或报“lua: command not found”主因是系统未正确安装 Lua 或 PATH 未配置，且构建文件 JSON 格式错误、selector 不匹配、中文路径或交互输入超出构建面板能力。
Sublime Text 本身不支持调试（debug），只能运行（build）Lua 脚本；所谓“调试”实际是靠终端手动加 print、配合 luacheck 静态检查，或外接 ledb/mobdebug 等远程调试器——但这些都不是 Sublime 原生功能。
为什么 Ctrl+B 不出结果，或者报 “lua: command not found”
这不是 Sublime 的问题，而是它根本没找到系统里的 Lua 解释器。Sublime 的构建系统只是调 shell 命令，lua -v 在终端里跑不通，它就一定失败。
- Windows：打开 CMD，执行
where lua或where luajit；没输出就说明 PATH 没设对，或根本没装解释器 - macOS：终端执行
which lua；若为空，用brew install lua@5.4（M1/M2 推荐），并记下真实路径（如/opt/homebrew/bin/lua），后面构建文件里得写死 - Linux：很多发行版默认装的是
lua5.4，命令不是lua，执行ls /usr/bin/lua*确认，然后在构建配置里严格匹配 - 改完 PATH 后必须彻底退出 Sublime 进程（不是关窗口），再重启——它只在启动时读一次环境变量
构建系统（.sublime-build）写错一个字符就静默失效
Sublime 对 JSON 格式零容忍：中文引号、多一个逗号、缩进混用 Tab、selector 不匹配插件注册的语言 ID，都会导致 Ctrl+B 没反应、也不报错。
-
"cmd"必须和终端里能敲通的命令完全一致：如果luajit -v有输出，就得写["luajit", "$file"]；Windows 上建议写["lua.exe", "$file"]，避免扩展名解析失败 -
"selector"必须跟插件对齐：装了LuaEnhanced插件，它注册的是source.lua.enhanced，这里就不能写source.lua -
"file_regex"决定点击错误能否跳转到对应行：标准 Lua 错误格式是test.lua:5: attempt to call a nil value，正则推荐用"^(*?):([0-9]+):?([0-9]*):? (.*)$"；Luajit 报错带列号（如:5:12），就得改成"^(.*?):([0-9]+):([0-9]+):" - 别用
"shell_cmd"：像"shell_cmd": "cd $file_path && lua $file_name"是无效的，Sublime 构建系统不支持&&；要用"working_dir": "$file_path"显式指定工作目录
中文路径、交互输入、闪退这些“假 bug”怎么处理
它们不是配置问题，而是 Lua 解释器和 Sublime 构建面板的能力边界限制。
- Windows 下中文路径容易触发
cannot open xxx: No such file or directory：Lua 5.3 及更早版本无法正确解析 GBK 编码路径；最稳方案是把.lua文件放在纯英文路径下（如C:/dev/test.lua） -
io.read()或其他 stdin 操作会卡住：Sublime 构建面板不提供真实终端输入能力，输出面板会挂起；要么改用命令行运行，要么临时注释掉交互逻辑 - 脚本一闪而过没看到输出：说明脚本执行完就退出了；可在末尾加
io.read()（仅限本地测试），或改用终端直接执行lua test.lua - 想看变量值？别依赖“调试”，直接加
print(tonumber(x), type(y))，这是最可靠的方式
真正难的不是写对 .sublime-build，而是理解 Sublime 从不“懂”Lua——它只负责调命令、捕获输出、解析错误行号。所有“调试感”都得靠你手动补全：选对解释器、压对路径、盯紧 selector 和 file_regex、接受没有断点和变量监视的事实。
