需配置构建系统调用系统Lua解释器：先确保终端能运行lua命令，再创建Lua.sublime-build文件指定"cmd": ["lua", "$file"]，保存后切换构建系统并按Ctrl-B运行。
怎么让 Sublime Text 直接运行 lua 脚本
Sublime Text 本身不内置 Lua 运行支持，必须靠构建系统（Build System）调用系统已安装的 lua 可执行文件。关键不是“装插件”，而是确保 lua 在终端能直接运行，再让 Sublime 知道它在哪。
常见错误现象：Unable to find command lua 或构建后窗口一闪而过、没输出、报错 'lua' is not recognized（Windows）/command not found: lua（macOS/Linux）——本质是路径没对上。
- 先在终端输入
which lua（macOS/Linux）或where lua（Windows CMD），确认lua命令可用且路径明确 - 如果返回空，说明没装 Lua 或没加进
PATH；推荐从 lua.org 下载二进制包，Windows 用户注意勾选“Add Lua to PATH” - Sublime 构建系统默认只认
PATH里的命令；如果你把lua装在非标准路径（比如C:lualua.exe），就得在构建文件里写死完整路径 - 新建构建系统：菜单 Tools → Build System → New Build System…，贴入以下内容并保存为
Lua.sublime-build
{
"cmd": ["lua", "$file"],
"selector": "source.lua",
"file_regex": "^(...*?):([0-9]*):?([0-9]*):? (.*)$",
"working_dir": "$file_path"
}
保存后切换到该构建系统（Tools → Build System → Lua），按 Ctrl+B（Windows/Linux）或 Cmd+B（macOS）即可运行当前文件。
lua 构建失败时怎么定位是环境还是语法问题
构建失败分两类：一类是 Sublime 根本没调起 lua（环境层），一类是 lua 启动了但脚本报错（语言层）。区别很简单：看 Sublime 底部状态栏和构建面板第一行。
- 如果第一行是
[WinError 2] The system cannot find the file specified或类似找不到命令的提示 → 环境问题，回头检查lua是否在PATH，或构建文件里路径写错 - 如果第一行是
lua: ./xxx.lua:5: attempt to call a nil value这类带行号和 Lua 错误信息的 → 环境正常，是代码问题；此时构建面板就是 REPL 式输出，可直接读错 - 注意 Windows 下若用 Git Bash 或 MSYS2 的
lua，路径含空格或特殊字符（如C:Program Files...）会导致构建失败；建议改用官方 Windows 二进制版，或在构建文件中用双引号包裹路径："cmd": [""C:\path\to\lua.exe"", "$file"]
想传参数给 lua 脚本，构建系统怎么改
默认构建只传 $file，没法像终端那样 lua script.lua arg1 arg2。要传参，得手动扩展 cmd 数组。
- 最简方式：把参数写死，比如
"cmd": ["lua", "$file", "hello", "world"]，适合调试固定场景 - 想动态传参，Sublime 不支持交互式输入，但可以用
$file_base_name、$packages等变量组合，或配合外部工具（如 AutoHotkey / Keyboard Maestro）预填剪贴板再粘贴进构建文件——但太重，一般没必要 - 更实用的做法：保留构建系统跑主流程，调试带参逻辑时，直接切到终端执行
lua script.lua arg1 arg2，反而更快；Sublime 的优势是编辑+快速执行，不是替代终端 - 注意：参数里含空格或特殊字符（如
hello world）时，Sublime 构建系统不会自动加引号，必须手动写成"hello world"，否则会被拆成两个参数
为什么有些 Lua 插件（如 LuaComplete）在 Sublime 里不工作
Sublime 的 Lua 补全/语法检查插件大多依赖本地 lua 解释器或 LSP 服务，但它们和构建系统是两套逻辑。插件失效通常不是配置错了，而是依赖链断了。
- 老插件（如 LuaComplete）基于 Sublime Text 2/3 的 API，ST4 兼容性差，且需要手动指定
lua路径；插件设置里找lua_path项，填和构建系统一致的路径 - 新方案是用
sublimelsp+lua-lsp（如sumneko/lua-language-server），但需额外下载语言服务器二进制，并在 LSP 设置中配好command和env；尤其 Windows 用户常卡在lua-language-server找不到lua—— 它也依赖PATH - 语法高亮基本没问题，因为 Sublime 自带
Lua语法定义（View → Syntax → Lua）；但函数跳转、hover 提示这类功能，没正确跑起来的 LSP 就是摆设
真正卡住人的地方，往往不是不会配，而是以为“装了插件就该有提示”，结果发现没反应，又去反复重装插件——其实该先验证 lua-language-server --version 能否在终端跑通。
