Sublime Text 本身不带 Lua 运行能力，必须依赖系统已安装的 lua（或 luajit）可执行文件及正确配置的构建系统；未安装解释器、PATH 配置错误、.sublime-build 文件存在语法错误（如标点、引号、缩进问题），均会导致 Ctrl+B 静默失败或报“command not found”。
Sublime Text 本身不带 Lua 运行能力，必须靠系统已安装的 lua（或 luajit）可执行文件 + 正确的构建系统配置才能运行脚本；没装解释器、PATH 没对上、.sublime-build 文件语法错一个标点，都会导致 Ctrl+B 静默失败或报“command not found”。
确认 lua 命令在终端能直接运行
这是整个流程的前提，Sublime 构建系统默认只从 PATH 查找命令，不会自己猜路径。
- 打开终端（Windows 是 CMD/PowerShell，macOS/Linux 是 Terminal），执行
lua -v；能输出类似Lua 5.4.6才算通过 - 如果报
'lua' is not recognized（Windows）或command not found: lua（macOS/Linux），说明没装或没加进PATH - Windows 用户推荐去 LuaBinaries 下载
lua-5.4.x_Win64_bin.zip，解压后把含lua.exe的文件夹路径加到系统环境变量PATH中 - macOS 用户用
brew install lua@5.4更稳妥（M1/M2 芯片避免装错架构）；Linux（如 Ubuntu）用sudo apt install lua5.4后，补软链接：sudo ln -sf /usr/bin/lua5.4 /usr/local/bin/lua
新建 Lua.sublime-build 并严格校验 JSON 格式
Sublime 对构建文件语法错误极其敏感：多一个逗号、引号用中文、缩进用 Tab、selector 缺失——全都会导致构建系统加载失败，且不报错，只是 Ctrl+B 没反应。
- 菜单 → Tools → Build System → New Build System…
- 粘贴以下内容（必须全英文引号、末尾有逗号、4 空格缩进、无 Tab）：
{ "cmd": ["lua", "$file"], "selector": "source.lua", "file_regex": "^(*?):([0-9]*):?([0-9]*):? (.*)$", "working_dir": "$file_path" } -
"selector": "source.lua"是关键，缺了它 Sublime 就不会自动为.lua文件启用这个构建系统 - 保存为
Lua.sublime-build，路径必须是Packages/User/（可通过 Preferences → Browse Packages… 打开） - 保存后务必重启 Sublime，或手动刷新：Tools → Build System → Refresh Projects
解决中文路径、空格路径和交互输入问题
这类问题在 Windows 上最典型，表现是 cannot open xxx: No such file or directory，本质是 Sublime 用系统 ANSI 编码（如 GBK）读取路径，而 lua.exe（尤其 5.4+）只认 UTF-8 路径，中间一转就丢字符。
- 最稳方案：把
.lua文件移到纯英文路径下，例如C:/lua-test/hello.lua，彻底避开编码陷阱 - 如果必须用中文路径，Windows 用户建议改用
luajit（对路径兼容性稍好），并在构建文件中写死绝对路径："cmd": ["C:\path\to\luajit.exe", "$file"]（注意双反斜杠） - 脚本里用了
io.read()或需要键盘输入？Sublime 构建面板不支持 stdin，此时会卡住或直接跳过；应改用终端运行，或在构建中加"target": "exec"并设"shell": true，但仍有局限，不推荐依赖 - 文件名含空格（如
my script.lua）也会触发解析失败；要么重命名，要么在构建中改用shell_cmd形式："shell_cmd": "lua "$file""（macOS/Linux）或"shell_cmd": "lua "$file""（Windows PowerShell）
验证构建是否生效及快速定位失败原因
别只盯着代码有没有报错，先看构建面板第一行输出——它直接告诉你问题是出在环境层还是语言层。
- 构建面板第一行是
[WinError 2] The system cannot find the file specified或类似找不到命令的提示 → 环境问题：回头检查lua是否真在PATH，或.sublime-build里路径写错了 - 第一行是
lua: ./test.lua:5: attempt to call a nil value这类带行号和 Lua 错误信息的 → 环境正常，是代码语法或逻辑问题；此时构建面板就是你的简易 REPL - 右下角状态栏显示的是
Plain Text而不是Lua？说明语法高亮没启用，Sublime 不会自动关联构建系统；手动点右下角 → 选Lua，或按Ctrl+Shift+P输入Set Syntax: Lua - 用了 Lua 插件（如
Lua Enhanced）？它的 scope 可能是source.lua.enhanced，此时要把构建文件里的"selector"改成对应值，否则不生效
最容易被忽略的是：Sublime GUI 应用（尤其是 macOS）启动时往往不继承 shell 的 PATH，所以即使终端里 lua -v 正常，Sublime 里仍可能找不到命令——这时必须在构建文件中写死 lua 的绝对路径，不能依赖 PATH 查找。
