sublime text 本身不支持 lua 真机调试，需依赖外部调试服务；确认 lua 解释器就绪是前提，须在终端验证 lua -v 或 luajit -v，并将路径正确加入系统 path，重启 sublime 后配置 lua.sublime-build 文件，确保 cmd、selector 和 file_regex 严格匹配实际环境。
Sublime Text 本身不支持 Lua 真机调试——它没有内置调试器，也不能直连嵌入式设备或游戏引擎进程；所谓“真机调试”，实际是 Sublime 作为编辑器，配合外部调试服务（如 mobdebug、ZeroBrane Studio 或自研调试代理）完成断点、变量查看等操作。
怎么确认 Lua 解释器已就绪且 Sublime 能调用
这是所有后续步骤的前提。Sublime 构建系统本质是调用 shell 命令，如果终端里 lua -v 或 luajit -v 都失败，Sublime 必然报 Unable to find command lua。
- Windows：打开 CMD，执行
where lua；无输出就去 luabinaries 下载二进制包，解压后把含lua.exe的目录加进系统 PATH - macOS：终端运行
which lua；若为空，用brew install lua@5.4（Apple Silicon 推荐），并记下实际路径（如/opt/homebrew/bin/lua），因为 GUI 启动的 Sublime 可能读不到 shell 的 PATH - Linux：运行
ls /usr/bin/lua*，常见命令是lua5.4而非lua，构建配置中必须严格匹配 - 改完 PATH 后，必须彻底退出 Sublime（右键菜单“退出”，不是关窗口），再重开——它只在启动时读一次环境变量
怎么写对 Lua.sublime-build 并让 Ctrl+B 真正生效
构建文件语法错一个标点，Sublime 就静默忽略，Ctrl+B 没反应也不报错。这不是插件问题，是 JSON 格式校验失败。
-
"cmd"必须和你终端验证过的命令一致：如果which luajit有输出，就得写["luajit", "$file"]；Windows 上建议用["lua.exe", "$file"]，避免扩展名解析歧义 -
"selector": "source.lua"是硬性要求——缺了这行，Sublime 根本不会把 .lua 文件和这个构建系统绑定；如果你装的是Lua Enhanced插件，它注册的是source.lua.enhanced，这里也得同步改 -
"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"：Sublime 构建系统不支持&&、cd等 shell 语法，"shell_cmd": "cd $file_path && lua $file_name"必然失败
怎么在 Sublime 里做“类真机”调试（mobdebug / ZeroBrane 场景）
Sublime 不提供调试 UI，但可通过 lua-language-server + SublimeLSP 提供跳转、补全、重命名等智能支持，再靠外部调试器接管执行流。
- 先装
lua-language-server：macOS 用brew install lua-language-server，Windows 去 GitHub Release 页面下载 zip 包，解压后把bin/目录加进 PATH - Sublime 里装
SublimeLSP（注意不是 “LSP”，少 “Sublime” 就错），然后在LSP.sublime-settings中添加lua配置块，指向你本地的lua-language-server可执行路径 - 调试逻辑仍需外部介入：比如在脚本开头加
require("mobdebug").start()，目标设备跑着 mobdebug 服务，Sublime 仅负责代码编辑和 LSP 提供的语义支持 - ZeroBrane Studio 用户可直接用它作为主 IDE，Sublime 仅作辅助编辑器——两者不冲突，但别指望 Sublime 自己弹出断点窗口
中文路径、空格路径和交互输入为什么总失败
这类问题集中在 Windows，表现是 cannot open xxx: No such file or directory，根源是编码错位：Sublime 用系统 ANSI（如 GBK）读路径，而 Lua 5.4+ 默认按 UTF-8 解析，中间一转就乱码。
- 最稳方案：把 .lua 文件放到纯英文路径下，例如
C:/lua-test/main.lua，彻底避开路径编码问题 - 如果必须用中文路径，Windows 上可尝试在构建配置中显式指定编码：
"encoding": "utf-8"，但不保证 100% 有效 - 交互输入（如
io.read()）在 Sublime 构建面板里无法响应——它不是完整终端，只是输出捕获器；需要交互的脚本，要么加io.read()防闪退，要么直接切到 CMD/PowerShell 运行 - Windows 上用 Git Bash 或 MSYS2 的
lua，路径含空格（如C:Program Files...）会导致构建失败；建议改用官方 Windows 二进制版，或在"cmd"中用双引号包裹路径：[""C:\Program Files\Lua\lua.exe"", "$file"]
真正卡住人的从来不是配置项本身，而是 Sublime 启动时读取的 PATH 和你终端里看到的 PATH 不是一回事，以及构建文件里一个中文逗号或 Tab 缩进就让整个系统静默失效——这些细节不亲眼确认，光抄配置没用。
