Sublime Text 需依赖系统已安装的 lua/luajit 命令才能运行 Lua 脚本；构建失败主因是环境或路径问题，须先确保终端中 lua -v 可用，再配置正确 .sublime-build 文件并设好 working_dir 和 file_regex。
Sublime Text 不能直接运行 Lua 脚本——它只是编辑器，必须依赖系统已安装且可调用的 lua 或 luajit 命令；构建失败 90% 是环境或路径问题，不是配置写得不够“高级”。
确认 lua 或 luajit 命令在终端可用
这是所有后续操作的前提。Sublime 的构建系统本质就是调 shell 命令，如果终端里都跑不通，Sublime 必然失败。
- 打开终端（Windows：CMD/PowerShell；macOS/Linux：Terminal），执行
lua -v或luajit -v - 能输出类似
Lua 5.4.6或LuaJIT 2.1.0-beta3才算通过 - 若报
command not found，Windows 用户需手动把lua.exe或luajit.exe所在目录加入系统 PATH；macOS 用户用brew install lua或brew install luajit；Linux 用户注意部分发行版默认装的是lua5.3，命令名可能不是lua，可用ls /usr/bin/lua*确认 - 改完 PATH 后，必须重启 Sublime（不是仅关闭窗口，要彻底退出进程），否则它读不到新环境变量
创建正确的 .sublime-build 文件
Sublime 不会自动识别 .lua 文件该用什么命令跑，必须靠 selector 字段绑定，且 JSON 格式容错率极低。
- 菜单栏 → Tools → Build System → New Build System…
- 粘贴以下内容（以标准 Lua 为例；若用 LuaJIT，请把
"cmd": ["lua", "$file"]改成"cmd": ["luajit", "$file"]）：{ "cmd": ["lua", "$file"], "selector": "source.lua", "file_regex": "^(*?):([0-9]+):?([0-9]+)?:? (.*)$" } -
"selector": "source.lua"是关键——没有这行，Sublime 根本不会把当前文件和这个构建系统关联 - 保存为
Lua.sublime-build（后缀必须是.sublime-build，文件名大小写不敏感但建议统一小写） - 别用 tab 缩进，全部用空格；每行结尾必须有英文逗号（最后一项除外）；所有引号必须是英文直引号
解决中文路径、交互输入、工作目录等运行时异常
即使构建系统语法正确，脚本仍可能因环境细节崩溃，尤其游戏开发中常见。
-
cannot open xxx: No such file or directory：Windows 下中文路径极易触发，lua.exe（尤其 5.3 及更早）无法正确解析 GBK 编码路径。最稳方案是把.lua文件移到纯英文路径下（如C:/dev/test.lua） -
io.read()或其他 stdin 操作卡住：Sublime 构建面板不提供真实终端输入能力，此时输出面板会挂起。要么改用终端运行，要么在构建系统中加"target": "exec"和"shell": true（但仍有局限，不推荐依赖） - 脚本依赖相对路径读取资源（如
love.graphics.newImage("assets/icon.png")）：需显式指定工作目录，在构建系统 JSON 中加一行"working_dir": "$file_path"，确保当前文件所在目录为运行起点 - macOS GUI 启动的 Sublime 常读不到 shell 的 PATH：用终端执行
subl启动编辑器，而非点击图标，可继承完整环境变量
让错误定位准、语法不踩坑
构建成功只是第一步，真正耗时的是看懂错误和避免低级语法问题。
- 错误跳转不准？检查
file_regex是否匹配实际报错格式。例如 LuaJIT 报错形如test.lua:7:12: attempt to call a nil value，就得用"file_regex": "^(.*?):([0-9]+):([0-9]+):"；而标准 Lua 5.4 多数只带行号，用"file_regex": "^(*?):([0-9]+):?([^:]*):? (.*)$"更稳妥 - 没语法高亮？先装插件
Lua或LuaExtended（不是SublimeLinter-lua），然后点右下角状态栏语言名 → 选Lua；若仍无效，检查是否误装了已废弃的lua-sublime - 想提前发现
end缺失、括号错位？装SublimeLinter+SublimeLinter-luacheck，但注意luacheck需单独安装（luarocks install luacheck），且 LuaJIT 用户得在 SublimeLinter 设置里手动指定"executable"路径
最常被忽略的其实是工作目录和编码一致性——哪怕构建系统全对，一个中文路径或一个未设 working_dir 就能让 require 或资源加载直接失败，而错误信息根本不提示根源在哪。
