Sublime Text 本身不带 Lua 运行能力，需系统已安装 lua/luajit 并配置 PATH；配置关键包括安装 Lua Enhanced 插件实现语法高亮、创建严格符合 JSON 规范的 Lua.sublime-build 文件（注意 selector、路径、编码），并确保右下角显示 Lua Enhanced 且构建系统被正确选中。
Sublime Text 本身不带 Lua 运行能力，所谓“一键运行”本质是调用系统已安装的 lua 或 luajit 可执行文件；配置失败绝大多数不是插件问题，而是构建系统没写对、解释器不在 PATH、或中文路径触发编码错位。
怎么让 Sublime 正确识别 .lua 文件并高亮
默认打开 .lua 文件就是纯文本，关键字不变色——这不是插件装错了，是 Sublime 根本没加载 Lua 语法定义。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package回车 - 搜
Lua Enhanced并安装（比原生Lua包支持更全，含注释折叠、require跳转） - 安装完后，打开任意
.lua文件 → 点右下角语言名（如 “Plain Text”）→ 选Lua Enhanced - 若仍无高亮，检查是否误装了废弃包（如
lua-sublime），卸载干净再重试
为什么 Ctrl+B 运行报 lua: command not found
这是最常卡住人的一步：Sublime 的构建系统只是发命令，它不负责装解释器，也不读你 shell 里的 PATH（尤其 macOS GUI 启动时）。
- 先在终端执行
lua -v或luajit -v，能输出版本号才算环境就绪 - Windows：从 LuaBinaries 下
lua-5.4.x_Win64_bin.zip，解压后把含lua.exe的目录加进系统环境变量PATH - macOS：用
brew install lua@5.4（M1/M2 更稳），然后确认which lua输出的是/opt/homebrew/bin/lua类路径 - Linux：可能默认装的是
lua5.4，但命令名不是lua，需建软链接：sudo ln -sf /usr/bin/lua5.4 /usr/local/bin/lua - 装完务必重启 Sublime，否则它读不到新
PATH
怎么写一个真正能用的 Lua.sublime-build
JSON 格式容错率极低，多一个逗号、引号用中文、缩进用 Tab，都会导致静默失败——Ctrl+B 按了没反应，连错误提示都没有。
- 菜单 →
Tools → Build System → New Build System… - 粘贴以下内容（注意全部用英文引号、每行结尾有逗号、缩进为 4 个空格）：
{
"cmd": ["lua", "$file"],
"selector": "source.lua.enhanced",
"file_regex": "^(*?):([0-9]+):?([0-9]+)?:? (.*)$",
"working_dir": "$file_path",
"encoding": "utf-8"
}
-
"selector"必须匹配你装的插件注册的 scope：Lua Enhanced是source.lua.enhanced，原生Lua插件才是source.lua -
"cmd"中的lua若仍找不到，改用绝对路径，例如 Windows：["C:/lua/lua.exe", "$file"]，macOS：["/opt/homebrew/bin/lua", "$file"] -
"working_dir": "$file_path"很关键：脚本里用io.open("data.txt")时，会以当前文件所在目录为根，而不是 Sublime 安装目录 - 保存为
Lua.sublime-build，文件必须放在Packages/User/目录下（可通过Preferences → Browse Packages…打开）
中文路径下运行失败 or 输出一闪而过怎么办
Windows 上最常见的两个陷阱：一是 Sublime 用 ANSI 编码读路径，lua.exe（5.4 前）只认 UTF-8，一碰就解析失败；二是控制台窗口进程结束太快，根本看不到 print 输出。
- 中文路径问题：直接把
.lua文件移到纯英文路径下测试，比如C:/dev/test.lua；这是最快验证是否路径编码导致失败的方法 - 输出闪退：Windows 下不要依赖双击或构建系统直接看结果，在脚本末尾加一行
io.read()，或改构建命令为：["cmd", "/c", "lua", "$file", "&", "pause"] - macOS/Linux 若用 zsh/bash 配置了别名（如
alias lua=luajit），Sublime 构建系统不继承别名，必须写死可执行文件名或绝对路径 - 脚本里用了
io.read()或等待 stdin 输入？Sublime 构建面板不支持交互式输入，此时必须切到终端运行
真正容易被忽略的点是：构建系统是否被正确关联。即使你保存了 Lua.sublime-build，如果当前文件右下角显示的不是 Lua Enhanced，Sublime 就不会自动启用这个构建系统——得先手动设置语法，再检查右下角是否出现 Lua 字样，最后再按 Ctrl+B。
