sublime text 需手动配置 lua 构建系统才能运行脚本；须先安装 lua 解释器并确保 lua 命令可在终端执行，再创建 lua.sublime-build 文件定义构建规则，注意路径、编码、工作目录及交互输入限制。
Sublime Text 本身不内置 Lua 运行支持，必须手动配置构建系统（Build System）才能运行 Lua 脚本；直接按 Ctrl+B 默认会报错 Unable to find target 或 lua: command not found。
确认本地已安装 Lua 解释器
Sublime 只是编辑器，不附带 Lua。运行脚本前必须确保系统 PATH 中能调用 lua 命令：
- Windows：安装 LuaDist 或 Lua for Windows，或手动把
lua.exe所在目录加入系统环境变量PATH - macOS：用
brew install lua；验证执行lua -v是否输出版本号 - Linux：多数发行版自带
lua5.3或lua5.4，但命令名可能不是lua，可用which lua或ls /usr/bin/lua*确认实际可执行文件名
创建 Lua 构建系统（Build System）
Sublime 通过 .sublime-build 文件定义如何执行代码。路径需严格匹配：
- 菜单栏 → Tools → Build System → New Build System…
- 替换默认内容为以下 JSON（注意
cmd中的命令名要与你系统实际一致，如lua5.4）：
{
"shell_cmd": "lua \"$file\"",
"file_regex": "^(...*?):([0-9]*):?([0-9]*)",
"selector": "source.lua",
"variants":
[
{
"name": "Run with args",
"shell_cmd": "lua \"$file\" $args"
}
]
}
保存为 Lua.sublime-build（文件名必须含 .sublime-build 后缀），默认保存位置即 Sublime 的 Packages/User/ 目录。
运行 Lua 脚本时的常见问题
即使构建系统存在，仍可能失败，原因多集中在路径和权限上：
-
lua: command not found：Sublime 在非登录 shell 下启动，PATH 不包含 Lua 安装路径（macOS/Linux 尤其明显）→ 改用绝对路径，如"shell_cmd": "/usr/local/bin/lua \"$file\"" - 中文路径或文件名导致乱码或报错 → 把 Lua 文件移到纯英文路径下再试
- 脚本中用了
io.read()或交互输入 → Sublime 的输出面板不支持 stdin 输入，此时应改用终端运行，或在构建系统中加"target": "exec"并启用"shell": true（但仍有局限） - 选错构建系统 → 保存文件后，检查右下角是否显示
Lua；若显示Plain Text，需先通过 View → Syntax → Lua 设置语法高亮，否则 Sublime 不会自动关联构建系统
调试与进阶提示
Sublime 没有原生 Lua 调试器，但可通过轻量方式辅助开发：
- 用
print(debug.traceback())快速定位错误栈 - 配合
lua-language-server+SublimeLSP插件实现跳转、补全、悬停提示（需额外安装，且 LSP 配置中command字段必须指向正确的lua-language-server可执行路径） - 避免在构建系统里写
shell_cmd为lua %FILE%（Windows 下旧式写法），$file是 Sublime 内置变量，跨平台兼容性更好
最常被忽略的是：Sublime 构建系统对当前工作目录（cwd）默认设为文件所在目录，但某些 Lua 包（如 lfs 或自定义 require 路径）依赖项目根目录 —— 此时需在 .sublime-build 中显式添加 "working_dir": "$file_path" 或 "working_dir": "$project_path"。
