Sublime Text 本身不运行 LuaJIT，只调用系统已安装的 luajit 命令；必须先在终端执行 luajit -v 验证可用性，再配置严格符合 JSON 规范的 Luajit.sublime-build 文件，确保 cmd 为 ["luajit", "$file"]、selector 匹配插件注册的语言 ID（如 source.lua）、working_dir 显式设为 "$file_path"，并保存至 Packages/User/ 目录。
Sublime Text 本身不运行 LuaJIT，它只调用你系统里已安装的 luajit 命令——所有“调试失败”“Ctrl+B 没反应”“command not found”，90% 是因为终端里根本跑不通 luajit -v，不是 Sublime 配错了。
确认 luajit 命令在终端可用
这是硬前提，跳过这步后续全白搭。Sublime 构建系统本质是起 shell 进程执行命令，终端里都找不到 luajit，它肯定失败。
- Windows：打开 CMD 或 PowerShell，执行
where luajit或luajit -v；没输出就说明没装或 PATH 没加对——去 luajit.org/download.html 下LuaJIT-2.1.0-beta3.zip（稳定版），解压后把含luajit.exe的目录（比如C:\luajit\）加进系统环境变量PATH - macOS：终端执行
which luajit；若为空，用brew install luajit（Apple Silicon 推荐），记下实际路径（如/opt/homebrew/bin/luajit） - Linux：执行
ls /usr/bin/luajit*看真实命令名（常见luajit-2.1），再用sudo ln -sf /usr/bin/luajit-2.1 /usr/local/bin/luajit补软链接 - 改完 PATH 后必须彻底退出 Sublime 进程再重启——它只在启动时读一次环境变量
配置 Build System 调用 luajit（不是 lua）
很多构建文件写 "cmd": ["lua", "$file"]，但你装的是 luajit，命令名不一致就会静默失败。必须和终端里能敲通的命令完全一致。
- 菜单栏 → Tools → Build System → New Build System…
- 粘贴以下内容（注意：
cmd用luajit，不是lua；Windows 用户建议写luajit.exe）：
{
"cmd": ["luajit", "$file"],
"file_regex": "^(*?):([0-9]*):?([0-9]*):? (.*)$",
"selector": "source.lua",
"working_dir": "$file_path"
}
- 保存为
Luajit.sublime-build（必须是这个文件名，后缀不能少），自动存到Packages/User/目录（可通过Preferences → Browse Packages…打开） -
working_dir必须显式指定——luajit加载模块或读取同目录文件时依赖当前工作目录，不能靠shell_cmd里的&&，Sublime 不支持 - 右下角状态栏确认选中的是
Luajit，不是Automatic或其他构建系统
让 .lua 文件正确高亮并绑定构建系统
如果打开 .lua 文件还是灰底白字，说明语言定义没装，构建系统也根本不会触发。
- 用 Package Control 安装插件
lua（名字就是lua，不是lua-enhanced或sublimelinter-lua） - 安装后打开任意
.lua文件 → 点右下角语言名（如 “Plain Text”）→ 选Lua - 检查
selector是否匹配：插件lua注册的语言 ID 是source.lua，所以构建文件里必须写"selector": "source.lua"；如果装了LuaEnhanced，它注册的是source.lua.enhanced，就得改成对应值 - 中文路径会导致
luajit报cannot open xxx: No such file or directory——luajit默认只认 UTF-8 路径，而 Windows 下 Sublime 传递的路径常被转成 GBK。最稳方案：把.lua文件全挪到纯英文路径下（如C:/dev/test.lua）
为什么 Ctrl+B 卡住或没输出
不是代码问题，是构建系统在交互场景下无响应。Sublime 的构建面板没有 stdin 输入能力，所有阻塞等待用户输入的操作都会卡死。
-
io.read()、os.execute("pause")、print("Press Enter..."); io.read()这类代码在构建面板里永远卡住，不会继续执行 - 想看到完整输出又不想切终端？删掉所有交互语句，或改用
print(os.date())这类非阻塞操作验证流程 - 如果脚本依赖 C 模块（如
luasocket），确保这些模块的.so/.dll文件路径在LUA_PATH或LUA_CPATH中，并且和luajit架构匹配（x64 luajit 只能加载 x64 模块） - 构建失败时控制台不报错？JSON 格式容错率极低：一个中文引号、多一个逗号、缩进用了 Tab，都会导致整个构建文件被静默忽略——用在线 JSON 验证器（如 jsonlint.com）校验后再保存
真正麻烦的从来不是配构建文件，而是 luajit 自身的路径处理、编码兼容性和模块加载链。哪怕 JSON 写得完美，只要 luajit 在终端里跑不通，或者模块路径没对上，Sublime 就只是个安静的编辑器。
