Sublime运行Lua脚本的前提是系统已安装lua或luajit且终端能执行lua -v；需先验证命令可用性，再配置严格符合JSON规范的Lua.sublime-build文件，确保cmd、selector、file_regex和保存路径正确。
lua命令在终端敲不通，Sublime肯定跑不了
所有构建失败的根源，90%出在这一步：Sublime 的构建系统本质就是调 shell 命令，lua -v 在 CMD/PowerShell/Terminal 里都执行不了，它根本不会尝试运行。
验证方式必须手动敲：
- Windows：打开 CMD 或 PowerShell，执行
where lua或lua -v；没输出就说明没装或 PATH 没生效 - macOS：终端执行
which lua；若为空，用brew install lua@5.4（M1/M2 推荐），记下实际路径（如/opt/homebrew/bin/lua） - Linux：执行
ls /usr/bin/lua*看真实命令名（常见lua5.4），再用sudo ln -sf /usr/bin/lua5.4 /usr/local/bin/lua补软链接
改完 PATH 后，必须彻底退出 Sublime 进程（任务管理器杀干净、活动监视器强制退出），再重启——它只在启动时读一次环境变量。
Lua.sublime-build 文件必须严格符合 JSON 规范
JSON 容错率极低，一个中文引号、多一个逗号、缩进用了 Tab，都会静默失效（Ctrl+B 没反应，也不报错）。
正确写法示例（注意引号是英文、末尾无逗号、路径用正斜杠或双反斜杠）：
{
"cmd": ["lua", "$file"],
"file_regex": "^(*?):(\d+):? (.*)$",
"selector": "source.lua.enhanced",
"working_dir": "$file_path"
}
关键点：
-
selector必须跟你安装的语言插件匹配：装了LuaEnhanced，它注册的是source.lua.enhanced，不能写source.lua - 别用
shell_cmd：像"shell_cmd": "cd $file_path && lua $file"会直接失败——Sublime 不支持&&，要用working_dir显式指定工作目录 - 文件必须保存在
Packages/User/目录下（可通过Preferences → Browse Packages…打开），文件名必须是Lua.sublime-build（后缀不能少）
中文路径或 io.read() 导致脚本卡死或报错
这是 Windows 游戏开发中最典型的坑：表现是 cannot open xxx: No such file or directory 或构建面板卡住不动。
根本原因是 lua.exe（尤其 5.4+）只认 UTF-8 路径，而 Sublime 在 Windows 下默认用 ANSI（GBK）读取路径，中间一转就丢字。
最稳方案：
- 把
.lua文件全挪到纯英文路径下（如C:/dev/test.lua） - 避免在脚本里用
io.read()、os.execute("pause")这类需要终端交互的操作——Sublime 构建面板不提供 stdin/stdout 交互能力，只会卡住或崩溃 - 如果非要调试输入，改用
print+ 手动传参（如arg[1]）或换专业调试器（如 ZeroBrane Studio）
语法高亮不生效，不是配置问题而是插件没装对
打开 .lua 文件还是灰白一片？这不是构建系统的事，是 Sublime 压根不认识 Lua 语法。
实操步骤：
- 用 Package Control 安装插件，就搜
Lua（名字就是这个，不是LuaEnhanced或lua-sublime） - 安装后，打开任意
.lua文件 → 点右下角语言名（比如 “Plain Text”）→ 选Lua - 如果仍不生效，检查是否误装了废弃包（如
lua-sublime），卸载干净再重装
装完后右下角显示 Lua 且关键字变色，才算真正就位。后续构建、快捷键才可能起作用。
