Sublime Text运行Lua脚本的前提是系统已安装lua或luajit且终端能执行lua -v；需先验证命令可用性，再配置严格符合JSON规范的Lua.sublime-build文件，确保cmd、selector、file_regex和保存路径正确。
Sublime Text 跑不了 Lua 脚本，除非你系统里真有 lua 或 luajit 命令，且 Sublime 能找到它——90% 的“配置失败”其实卡在这一步，不是 JSON 写错，也不是插件没装对。
怎么确认 lua 命令在终端能跑通
这是所有后续操作的硬前提。Sublime 构建系统本质就是调 shell 命令，终端里都敲不出 lua -v，它肯定失败。
- Windows：打开 CMD 或 PowerShell，执行
where lua或lua -v；没输出就说明没装或 PATH 没加对——去 luabinaries.org 下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 进程再重启——它只在启动时读一次环境变量
为什么 Ctrl+B 没反应或报 command not found
不是插件问题，是构建系统根本没加载成功。JSON 格式容错率极低，一个中文引号、多一个逗号、缩进用了 Tab，都会静默失效（不报错，只是 Ctrl+B 没反应）。
-
"cmd"必须跟你终端里真实能敲通的命令一致：如果luajit -v有输出，就得写["luajit", "$file"]；Windows 上建议写["lua.exe", "$file"]，避免扩展名解析歧义 -
"selector"必须跟已安装插件注册的语言 ID 对齐：装了LuaEnhanced插件，它注册的是source.lua.enhanced，那这里就不能写source.lua，否则 Sublime 根本不绑定 - 保存路径必须是
Packages/User/（可通过Preferences → Browse Packages…打开），文件名必须是Lua.sublime-build（后缀不能少） - 别用
"shell_cmd"：像"shell_cmd": "cd $file_path && lua $file"会直接失败——Sublime 不支持&&，要用"working_dir": "$file_path"显式指定工作目录
中文路径或 io.read() 导致脚本崩溃怎么办
这类问题在 Windows 游戏开发中特别典型，表现是 cannot open xxx: No such file or directory 或构建面板卡死不动。
- 根本原因是
lua.exe（尤其 5.4+）只认 UTF-8 路径，而 Sublime 在 Windows 下默认用 ANSI（GBK）读取路径，中间一转就丢字——最稳方案是把.lua文件全挪到纯英文路径下（如C:/dev/test.lua） -
io.read()、os.execute("pause")这类需要终端交互的操作，在 Sublime 构建面板里无法响应，输出会挂起；临时解决可加io.read()在脚本末尾，或改"cmd"为["cmd", "/c", "lua", "$file", "&", "pause"]（仅 Windows） -
"file_regex"决定点击错误能否跳转：标准 Lua 错误格式是test.lua:5: attempt to call a nil value，正则用"^(*?):([0-9]+):?([0-9]*):? (.*)$"；如果用luajit，错误带列号（如:5:12），就得改成"^(.*?):([0-9]+):([0-9]+):"
真正容易被忽略的是：Sublime 从不“自动适配”你的解释器版本或插件语言 ID，selector 和 cmd 必须手工对齐；还有，GUI 启动的 Sublime（比如 macOS 点图标打开）可能读不到 shell 的 PATH，这时候写死绝对路径反而更可靠。
