Sublime Text 不能直接运行 Lua 脚本，必须依赖系统已安装且 PATH 可访问的 lua 或 luajit 命令；首要验证终端执行 lua -v 是否成功，否则所有构建配置均无效。
Sublime Text 本身不运行 Lua，它只是调用你系统里已装好的 lua 或 luajit 命令；只要终端里 lua -v 报错，所有构建配置都无效。
确认 lua 命令在终端可用
这是最常被跳过的一步，但 90% 的失败卡在这儿。Sublime 构建系统本质就是执行 shell 命令，它不会帮你装解释器，也不会读你没生效的 PATH。
- 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@5.4（Apple Silicon 推荐）；注意 GUI 启动的 Sublime 可能读不到 shell 的 PATH，建议记下实际路径（比如/opt/homebrew/bin/lua），后面直接写死 - Linux：运行
which lua5.4或ls /usr/bin/lua*；很多发行版默认命令是lua5.4而非lua，这点必须和构建系统里的"cmd"字段严格一致
改完 PATH 后务必彻底退出 Sublime（不是关窗口，要杀进程），否则它启动时只读一次环境变量，不重启等于白改。
新建 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 语法，&&会直接导致失败
让 .lua 文件正确高亮并绑定语法
默认安装的 Sublime Text 不带 Lua 支持，打开 .lua 文件就是纯文本——连关键字都不变色。这不是插件没装对，而是根本没启用 Lua 语法定义。
- 菜单栏点击
View → Syntax → Open all with current extension as… → Lua；这一步会把当前文件和所有同后缀文件绑定到 Lua 语法包 - 如果列表里没有
Lua，说明语法包缺失，需按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板，输入Package Control: Install Package回车，搜Lua Enhanced安装（比原生 Lua 包支持更全，包括注释折叠、require跳转） - 装完后重新打开
.lua文件，语法高亮、括号匹配、缩进自动对齐就都回来了
避开中文路径和编码陷阱
这类问题在 Windows 上最典型，表现是 cannot open xxx: No such file or directory，本质是 Sublime 用系统 ANSI 编码（如 GBK）读取路径，而 lua.exe（尤其 5.4+）只认 UTF-8 路径，中间一转就丢字符。
- 最稳方案：把
.lua文件移到纯英文路径下，例如C:/lua-test/hello.lua，彻底避开编码陷阱 - 如果必须处理中文，构建系统里可加
"encoding": "UTF-8"字段，但这仅影响 Sublime 捕获输出的解码方式，不改变子进程内部编码逻辑 - 别依赖
os.getenv("USERPROFILE")拼路径 —— Windows 用户目录名是中文时，这里返回的就是乱码，改用os.getenv("HOMEDRIVE")..os.getenv("HOMEPATH")
真正容易被忽略的是：Sublime 启动时只读一次环境变量，PATH 改了不彻底退出重开，Ctrl+B 就永远找不到 lua；还有就是 selector 值必须和你实际使用的语法包 scope 完全一致，哪怕多一个点、少一个下划线，构建系统就形同虚设。
