Sublime Text保存Lua文件自动运行需依赖On Save Build插件监听on_post_save_async事件并调用Lua构建系统;必须配置正确的lua路径、selector(如source.lua.enhanced)和working_dir,且修改PATH后须彻底重启Sublime。

Sublime Text保存Lua文件时自动运行脚本,靠的是插件监听事件
Sublime Text 本身不支持保存即执行,必须借助插件触发构建(Build)系统。核心路径只有一条:保存 → 插件捕获 on_post_save_async → 调用已配置好的 Lua 构建系统。没有“内置调试断点”功能,所谓“自动调试”实际是自动运行 + 手动加 print 或用 debug.debug() 临时介入。
On Save Build 是最稳的选择,不是 Save Actions
Save Actions 插件对 Lua 支持弱,"run_command" 在 Lua 场景下常静默失败;而 On Save Build 专为“保存即构建”设计,与 Sublime 的构建系统深度绑定,成功率高、配置轻量。
- 用
Package Control: Install Package安装On Save Build - 右键编辑区 → 选
Enable On Save Build(或菜单Tools → On Save Build → Enable) - 确保你已有一个可用的
Lua.sublime-build(见下一条),且当前文件语言被识别为Lua Enhanced或Lua - 启用后,保存
.lua文件会立刻触发构建 —— 不需要额外快捷键
Lua.sublime-build 必须严格匹配解释器路径和 selector
构建系统失效,90% 是因为 "cmd" 指向了不存在的命令,或 "selector" 和当前文件语言 ID 不一致。这不是语法错误,而是 Sublime 根本不“认”这个构建系统。
- 先在终端确认真实可用命令:
which lua(macOS/Linux)或where lua(Windows);若返回空,就得用绝对路径,比如["C:/lua/lua.exe", "$file"] -
"selector"必须和你右下角显示的语言名完全对应:装了LuaEnhanced插件就写"source.lua.enhanced";没装就写"source.lua"(别写错大小写或漏点) - 加
"working_dir": "$file_path",否则require相对路径或io.open读取同目录文件会失败 - 别用
"shell_cmd",Sublime 构建系统不解析&&或管道,"shell": true也无效
一个最小可用示例(适配 LuaEnhanced):
{
"cmd": ["lua", "$file"],
"working_dir": "$file_path",
"selector": "source.lua.enhanced",
"file_regex": "^(*?):([0-9]+):?([0-9]*):? (.*)$"
}
环境变量 PATH 修改后必须彻底重启 Sublime
GUI 启动的 Sublime(比如从 Dock 或开始菜单点开)不会继承 shell 的 PATH,它只在启动瞬间读一次系统环境变量。改完 PATH 后只刷新窗口或重载插件没用。
- macOS:关闭所有 Sublime 窗口后,终端执行
open -n -a "Sublime Text"启动,才能读到brew装的lua - Windows:任务管理器里结束所有
subl.exe进程,再重新打开 - Linux:确保不是通过桌面快捷方式(可能缓存旧环境),改用终端
subl启动
最容易被忽略的是:Lua 构建系统不报错也不提示——Ctrl+B 没反应、保存后没输出,大概率是解释器路径或 selector 错了,而不是插件没装好。











