Sublime Text 可通过配置原生构建系统实现 Lua 脚本运行，前提是系统已正确安装并配置 Lua 环境变量；需新建 Build System 文件，设置 shell_cmd 为 lua "$file"，并确保右下角选中该构建系统，再按 Ctrl-B/Cmd-B 执行。
Sublime Text 本身不内置 Lua 运行支持，但通过插件 + 正确的系统级配置，可以实现“保存即运行”或快捷键触发执行。关键不是装一堆插件，而是让 subl 能调用你本地已安装的 lua 可执行文件，并正确捕获输出。
确认系统已安装 Lua 并可命令行调用
这是最常被跳过的一步，也是后续所有插件失效的根源。Sublime 的构建系统（Build System）本质是调起 shell 执行命令，如果终端里都跑不了 lua your_script.lua，Sublime 肯定也不行。
- 在终端输入
lua -v，应返回类似Lua 5.4.6；若提示command not found，先装 Lua（macOS 用brew install lua，Windows 从 luabinaries 下载并把lua.exe所在目录加进PATH） - 验证路径：Windows 用户尤其注意，不要用
luajit.exe冒充lua.exe—— 多数插件和构建系统默认找的是lua，不是luajit - 避免使用 MinGW/MSYS2 的
lua，它们的环境变量和路径处理容易和 Sublime 构建系统冲突
配置 Sublime 原生 Build System（推荐，轻量可靠）
不用额外插件，直接用 Sublime 自带的构建功能，稳定且无兼容问题。适用于 Lua 5.1–5.4，也兼容 luajit（需手动改名或指定路径）。
操作步骤：
- 菜单栏 → Tools → Build System → New Build System…
- 替换全部内容为以下 JSON（注意
cmd中的lua要和你终端里能调用的命令一致；Windows 用户把lua改成lua.exe更稳妥）：
{
"shell_cmd": "lua \"$file\"",
"file_regex": "^(...*?):([0-9]*):?([0-9]*):? (.*)$",
"selector": "source.lua",
"syntax": "Packages/Lua/Lua.sublime-syntax"
}
- 保存为
Lua.sublime-build（自动存到Packages/User/目录） - 打开一个
.lua文件，按Ctrl+B（Windows/Linux）或Cmd+B（macOS），即可看到输出
⚠️ 注意：file_regex 这一行用于点击错误行跳转，Lua 默认报错格式如 test.lua:3: attempt to call a nil value，该正则能匹配；若你用的是自定义错误处理器或 luacheck，需另行调整。
Build System 不生效？检查这三处
常见“点了 Ctrl+B 没反应”或“报错找不到 lua”的真实原因：
-
Build System没选对：右下角状态栏确认是否为Lua，不是Automatic或其他；菜单 Tools → Build System 里手动选一次 - Sublime 启动时未加载
PATH：macOS / Linux 图形界面启动的 Sublime，可能没继承 shell 的PATH。解决方法：终端中执行subl .启动 Sublime，或在~/.zshrc（或~/.bash_profile）里确保export PATH=...生效且被 GUI 加载 - 脚本路径含中文或空格：虽然
"$file"用了双引号，但某些旧版 Sublime 或 Windows cmd 仍有问题。临时测试可先将文件移到纯英文无空格路径（如/tmp/test.lua）
要不要装 Terminus 或 Lua IDE 插件？
像 Terminus（终端嵌入）、SublimeLinter-lua（语法检查）、lua-completions（补全）这类插件，属于增强体验，不是“运行脚本”所必需。
-
Terminus：适合需要交互式 Lua REPL（比如调试io.read()），但它不替代构建系统；开启后仍需手动输lua script.lua -
SublimeLinter-lua：依赖luacheck，要单独npm install -g luacheck或luarocks install luacheck，和运行脚本无关 - 所谓“一键运行 Lua 插件”（如旧版
SublimeText-Lua-Runner）大多已停止维护，且内部仍是调构建系统，还多一层抽象，出问题更难排查
真正卡住的永远是 lua 命令在哪、能不能被 Sublime 进程访问到——这个环节搞定了，剩下的只是让输出看起来更顺眼而已。
