sublime text 本身不运行 lua，只调用系统已安装的 lua 或 luajit；配置失败主因是解释器不可达、.sublime-build 语法错误或 selector 不匹配，须先验证终端可执行 lua -v，再严格按 json 规范配置构建系统并确保 selector 与插件 scope 一致。
Sublime Text 本身不运行 Lua，它只调用系统里已安装的 lua 或 luajit 可执行文件；配完按 Ctrl+B 没反应、报 lua: command not found、错误跳转错行——问题几乎都出在解释器不可达、.sublime-build 文件语法错位或 selector 不匹配上。
确认 lua 命令在终端能直接执行
这是所有配置生效的前提。Sublime 构建系统不读 shell 配置，也不猜路径，只从启动时加载的 PATH 里找命令。
- Windows：打开 CMD，执行
where lua；没输出就说明没装或没加进系统环境变量 PATH —— 推荐去 LuaBinaries 下lua-5.4.x_Win64_bin.zip，解压后把含lua.exe的目录（如C:\lua\）加进“系统变量”里的 PATH - macOS：终端执行
which lua；若为空，用brew install lua@5.4（M1/M2 芯片更稳），装完记下实际路径（比如/opt/homebrew/bin/lua），后续可能得写死 - Linux：执行
ls /usr/bin/lua*，常见是lua5.4；需补软链接：sudo ln -sf /usr/bin/lua5.4 /usr/local/bin/lua - 改完 PATH 后必须彻底退出 Sublime（不是关窗口，要杀进程），再重开——否则它仍读旧环境
Lua.sublime-build 文件必须严格符合 JSON 规范
Sublime 对构建文件语法错误零容忍：多一个逗号、引号是中文、缩进用 Tab、漏 selector——全都会静默失效，Ctrl+B 按了像没按。
- 菜单 →
Tools→Build System→New Build System… - 粘贴以下内容（注意全部英文引号、末尾逗号、4 空格缩进、无 Tab）：
{
"cmd": ["lua", "$file"],
"selector": "source.lua",
"file_regex": "^(*?):([0-9]+):?([0-9]*):? (.*)$",
"working_dir": "$file_path"
}
-
"selector": "source.lua"是硬性要求，缺了 Sublime 就不会自动为.lua文件启用这个构建系统 - 如果你装的是
Lua Enhanced插件，它注册的 scope 是source.lua.enhanced，那这里就得同步改成"selector": "source.lua.enhanced" - 保存为
Lua.sublime-build，路径必须是Packages/User/（可通过Preferences→Browse Packages…打开）
为什么错误点击跳转总不对行号
根本原因是 file_regex 没匹配上 Lua 实际报错格式。默认错误形如 test.lua:5: attempt to call a nil value，但 luajit 可能带列号（:5:12），而 Windows 下中文路径还可能触发编码错位。
- 标准 Lua（5.4+）推荐用：
"file_regex": "^(*?):([0-9]+):?([0-9]*):? (.*)$" - 若用
luajit且错误含列号（如test.lua:5:12: bad argument），得改成："file_regex": "^(.*?):([0-9]+):([0-9]+):(.*)$" - 中文路径下报
cannot open xxx: No such file or directory，本质是 Sublime 用 ANSI 编码读路径，而lua.exe（尤其 5.4+）只认 UTF-8——最稳方案是把.lua文件移到纯英文路径下再试
交互式输入（如 io.read()）在 Sublime 里会卡住
Sublime 的输出面板不支持 stdin 输入，一旦脚本里有 io.read() 或 os.execute("pause")，构建就会挂起、无响应、不报错。
- 这不是配置问题，是 Sublime 构建系统的固有限制
- 临时解决：把交互逻辑注释掉，或改用
print+ 手动传参方式验证逻辑 - 长期方案：脚本开发阶段直接在终端运行，
cd /path/to && lua main.lua；Sublime 专注编辑和快速非交互验证 - 别试图用
"shell_cmd": "lua \"$file\""绕过——Sublime 构建系统不支持 shell 语法，&&或管道会直接失败
真正容易被忽略的是：Sublime 启动时只读一次环境变量，PATH 改了不重启等于白改；还有 selector 必须和你所用插件注册的 scope 完全一致，哪怕多一个点或大小写错，构建系统就形同虚设。
