Sublime Text 本身不内置 Lua 解释器，必须依赖系统已安装的 lua 或 luajit 命令；首要步骤是终端执行 lua -v 验证命令可用，否则构建系统无法生效。
Sublime Text 本身不带 Lua 解释器，也**不能直接运行 Lua 脚本**——它只是调用你系统里已安装的 lua 或 luajit 命令。只要终端能跑 lua -v，Sublime 就能配；否则所有构建配置都白搭。
确认 lua 命令在终端可用
这是最常被跳过的一步，但失败 90% 都卡在这儿。
- Windows：打开 CMD 或 PowerShell，执行
where lua；没输出就说明没加进 PATH，或根本没装 —— 去 luabinaries 下lua-5.4.x_Win64_bin.zip，解压后把含lua.exe的目录（如C:\lua\）加进系统环境变量 PATH - macOS：终端执行
which lua；若为空，用brew install lua（Apple Silicon 推荐brew install lua@5.4）；注意 GUI 启动的 Sublime 可能读不到 shell 的 PATH，所以最好记下实际路径（比如/opt/homebrew/bin/lua），后面直接写死 - Linux：运行
which lua5.4或ls /usr/bin/lua*，很多发行版默认命令是lua5.4而非lua，这点必须和构建系统里"cmd"保持一致 - 验证完别忘了重启 Sublime —— 它启动时只读一次环境变量，改了 PATH 不重启等于没改
新建 Lua.sublime-build 并填对关键字段
Sublime 构建系统是 JSON 格式，语法容错极低：多一个逗号、引号用中文、缩进混用 tab，都会静默失效（Ctrl+B 没反应，也不报错）。
-
"cmd"必须匹配你系统真实可用的命令：如果which lua返回空但which luajit有结果，就得写["luajit", "$file"]；Windows 上建议写["lua.exe", "$file"]，避免扩展名解析问题 -
"selector": "source.lua"是硬性要求 —— 没这行，Sublime 根本不会对.lua文件启用该构建系统；如果你装了lua-enhanced插件，它注册的是source.lua.enhanced，那这里就得同步改成对应值 -
"file_regex"决定错误点击能否跳转到对应行：Lua 默认报错格式是test.lua:5: attempt to call a nil value，推荐用"^(*?):([0-9]+):?([0-9]*):? (.*)$"；如果用luajit，错误末尾可能带列号（如:5:12），就得改成"^(.*?):([0-9]+):([0-9]+):" - 不要写
"shell_cmd": "cd $file_path && lua $file_name"—— Sublime 构建系统不支持 shell 语法，&&会直接导致失败
解决中文路径、闪退、无输出等典型现象
这些问题看着像 Sublime 的 bug，其实全是路径、编码或 stdin 限制惹的祸。
- 报错
cannot open xxx: No such file or directory（尤其 Windows）：不是文件不存在，是 Sublime 用 ANSI（如 GBK）编码读取了含中文的路径，而lua.exe（5.4 前）只认 UTF-8 路径 —— 最稳解法：把.lua文件移到纯英文路径下（如D:/code/test.lua） - Windows 下 Ctrl+B 后窗口一闪而过，看不到
print()输出：这不是 Sublime 问题，是进程结束太快。可在脚本末尾加io.read()等待输入；或改构建系统为"cmd": ["cmd", "/c", "lua", "$file", "&", "pause"] - 输出面板空白、没任何内容：检查是否误用了
io.read()或os.execute("pause")—— Sublime 的输出面板不支持 stdin 输入，这类交互式语句会导致构建卡住或静默退出 - 右下角状态栏显示 “Plain Text” 而不是 “Lua”：说明语法高亮没生效，先按
Ctrl+Shift+P输入Set Syntax: Lua手动切换；若无此选项，需先装LuaEnhanced插件（通过 Package Control 安装）
调试与长期维护的隐藏要点
真正容易被忽略的，不是“怎么配”，而是“怎么让配置持续有效”。
- Sublime 的
Packages/User/目录是唯一安全的保存位置 —— 用Preferences → Browse Packages…打开，确保Lua.sublime-build文件放在这里，而不是桌面或下载目录 - macOS 上从 Finder 启动 Sublime，PATH 常丢失；解决办法是始终从终端启动：
subl（前提是已配置 shell 命令），这样它能继承完整的环境变量 - 构建系统里别依赖
$file_name或$file_base_name做路径拼接 ——$file是完整路径，$file_path是目录，其他变量在某些场景下可能为空或出错 - 如果项目依赖特定工作目录（比如读取同级
assets/），一定要显式写"working_dir": "$file_path"，否则io.open("config.json")会去 Sublime 安装目录下找
