sublime text 本身不运行 lua，也不自带解释器；能一键运行的唯一前提是系统 path 中已存在可用的 lua 或 luajit 命令，且构建配置严格匹配其调用方式。90% 的“ctrl+b 没反应”“command not found”都卡在这一步，不是插件没装对，是命令根本没找着。
Sublime Text 本身不运行 Lua，也不自带解释器；能一键运行的唯一前提是：系统 PATH 中已存在可用的 lua 或 luajit 命令，且构建配置严格匹配其调用方式。90% 的“Ctrl+B 没反应”“command not found”都卡在这一步，不是插件没装对，是命令根本没找着。
确认终端里 lua 或 luajit 真的能跑
这是所有后续操作的硬门槛，跳过等于白配。
- Windows：打开 CMD 或 PowerShell，执行
where lua或where luajit；有输出（比如C:\lua\lua.exe）才算通过；没输出就去 luabinaries 下载预编译包，解压后把含lua.exe或luajit.exe的目录加进系统 PATH - macOS：终端执行
which lua或which luajit；若为空，用brew install lua@5.4（Apple Silicon 推荐）或brew install luajit；注意 GUI 启动的 Sublime 可能读不到 shell 的 PATH，建议记下实际路径（如/opt/homebrew/bin/lua），后面直接写死 - Linux：运行
which lua5.4或ls /usr/bin/lua*；很多发行版默认命令是lua5.4而非lua，这点必须和构建系统里的"cmd"字段完全一致 - 改完 PATH 后，必须彻底退出 Sublime 进程再重启——它只在启动时读一次环境变量
Lua.sublime-build 文件必须满足这四个条件
JSON 格式容错率极低，一个标点错就静默失效（Ctrl+B 没反应，也不报错）。
-
"cmd"必须是你终端里真实能敲出来的命令：如果luajit -v有输出，就得写["luajit", "$file"]；Windows 上建议写["lua.exe", "$file"]，避免扩展名解析问题 -
"selector": "source.lua"是硬性要求；如果你装了Lua Enhanced插件，它注册的是source.lua.enhanced，这里就必须同步改成对应值，否则 Sublime 根本不会绑定构建系统 -
"file_regex"决定错误点击能否跳转到行号；Lua 默认报错格式是test.lua:5: attempt to call a nil value，推荐用"^(*?):([0-9]+):?([0-9]*):? (.*)$"；如果用luajit且错误带列号（如:5:12），就得改成"^(.*?):([0-9]+):([0-9]+):" - 别用
"shell_cmd"：例如"shell_cmd": "cd $file_path && lua $file_name"在 Sublime 构建系统中不支持&&，会直接失败；要用"working_dir": "$file_path"显式指定工作目录
Windows 下脚本一闪而过？得处理交互和编码
尤其游戏开发中常需读取本地资源（如 love.graphics.newImage("assets/icon.png")），路径、编码、控制台生命周期都容易出问题。
- 中文路径或含空格路径易报
cannot open xxx: No such file or directory：本质是 Sublime 用系统 ANSI 编码（如 GBK）传路径，而lua.exe（尤其 5.4+）只认 UTF-8；最稳方案是把 .lua 文件放在纯英文无空格路径下 - 控制台闪退：Windows 默认用
cmd /c启动，执行完就关；可在脚本末尾加io.read()，或把构建系统的"cmd"改成["cmd", "/c", "lua", "$file", "&", "pause"] - 若游戏引擎（如 LÖVE 11.x）强制依赖 Lua 5.1，而系统默认是 5.4，就得单独下载 Lua 5.1，并在构建系统中写死绝对路径，例如
["C:/lua51/lua.exe", "$file"]
语法高亮和补全不是靠构建系统，而是靠插件和 scope 绑定
很多人装了一堆插件却 Ctrl+B 没反应，就是因为混淆了“编辑体验”和“运行能力”。
- 打开 .lua 文件右下角显示 “Plain Text”，说明没绑定语法；点击它 → 选
Lua即可；若列表里没有，就按Ctrl+Shift+P→ 输入Package Control: Install Package→ 安装Lua Enhanced（推荐，支持require跳转、注释折叠） -
Lua Enhanced注册的 scope 是source.lua.enhanced，所以构建系统里的"selector"必须同步改成这个值，否则高亮有了，运行还是失败 - 补全和 API 提示（如 LÖVE 的
love.graphics）需要额外插件配合，比如sublimecodeintel+love.lua语言定义，但这些不影响 Ctrl+B 是否能跑起来
最容易被忽略的其实是工作目录和错误正则的耦合：游戏脚本往往依赖 $file_path 作为资源根目录，而 file_regex 写错会导致点击报错无法跳转——这两处一旦配错，调试效率直接归零。
