Sublime Text 不支持 Lua 原生调试，仅能通过 print/error 手动打点；Ctrl+B 无反应或报 “lua not found” 是因构建系统中 "cmd" 未匹配终端真实可用命令、"selector" 与右下角语言模式不一致、或 PATH 修改后未彻底重启 Sublime。
Sublime Text 本身不支持 Lua 原生调试（断点、单步、变量监视），所谓“调试”只能靠 print 或 error 手动打点；但快捷键运行可以稳定实现，关键在构建系统配置是否匹配你实际的 Lua 可执行路径和 scope。
为什么 Ctrl+B 按了没反应或报 “lua not found”
这不是 Sublime 的问题，而是它根本没找到 lua 命令——构建系统里的 "cmd" 字段必须和你在终端里敲的一模一样。
- Windows 用户先打开 CMD，执行
where lua；如果返回空，说明 PATH 没配对，或者你装的是lua54.exe而不是lua.exe - macOS/Linux 用户运行
which lua5.4（注意：很多系统默认不带lua命令，只有lua5.4） - 如果你用的是 Lua Enhanced 插件，它的语法识别 scope 是
source.lua.enhanced，但构建系统里写的是"selector": "source.lua"，就会静默失效 - Sublime 启动后才读一次 PATH，改完环境变量必须彻底退出进程再重开，不能只关窗口
构建系统文件必须严格校验的三项
新建 Tools → Build System → New Build System…，粘贴以下内容并保存为 lua.sublime-build（必须放 Packages/User/ 目录下）：
{
"cmd": ["lua", "$file"],
"selector": "source.lua",
"file_regex": "^(*?):([0-9]+):?([0-9]*):? (.*)$",
"working_dir": "$file_path"
}
-
"cmd"：若终端中需输入luajit test.lua，这里就得写["luajit", "$file"]；Windows 上建议显式写["lua.exe", "$file"]避免扩展名解析歧义 -
"selector"：值必须与当前文件右下角显示的语言模式完全一致（点开 plain text 查看），常见有source.lua、source.lua.enhanced、source.lua.luacheck -
"file_regex"：决定点击错误能否跳转到对应行。Lua 默认报错如test.lua:3: attempt to call a nil value，正则要能捕获文件名和行号；luajit 报错带列号（如:3:12），就得改成"^(.*?):([0-9]+):([0-9]+):"
中文路径下运行失败：不是编码问题，是路径传递被截断
报错 cannot open xxx: No such file or directory 在 Windows 上大概率是因为 Sublime 用 ANSI 编码读取了含中文的 $file 路径，而 Lua 5.4 之前只接受 UTF-8 编码路径，中间字符一丢，路径就错了。
- 最稳解法：把项目移到纯英文路径下，比如
C:/dev/lua-demo/ - 次选方案：不用
$file，改用绝对路径调用，例如"cmd": ["C:\lua\lua54\lua54.exe", "C:\dev\test.lua"]（注意双反斜杠） - 不要试图改 Sublime 的文件编码设置——它读的是路径字符串本身，不是文件内容编码
别信“调试”宣传，真实可用的只有运行 + 格式化 + 检查
Sublime 没有集成 Lua 调试器，所谓“添加断点”全是误导。你真正能落地的增强项只有三件：
- 用
Pretty Lua插件 +StyLua二进制，绑定快捷键ctrl+alt+shift+l实现一键格式化 - 用
SublimeLinter+luacheck显示潜在错误（比如未声明变量、死代码），但需手动安装 luacheck 并在插件设置里填路径 - 运行时加
-i参数进入交互模式（如"cmd": ["lua", "-i", "$file"]），适合快速验证函数行为，但无法设断点
所有“调试”功能都依赖外部工具链（如 ZeroBrane Studio），Sublime 只负责把命令发出去。路径、scope、编码这三点卡住，其他都白搭。
