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 格式容错率极低。

Audiobox

Audiobox是一款AI音频处理工具，Meta推出的免费AI语音和声音生成模型。

下载

• 菜单栏 → 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 或资源加载直接失败，而错误信息根本不提示根源在哪。