Sublime Text 不运行 Lua，仅调用系统解释器；确认 lua/luajit -v 可用是前提，PATH 修改后需彻底退出 Sublime；.sublime-build 文件须语法严谨、路径正确、selector 匹配插件；游戏脚本需热重载而非本地执行。
Sublime Text 本身不运行 Lua，它只调用你系统里已装好的 lua 或 luajit；所谓“一键运行游戏脚本”，本质是让构建系统把文件复制进游戏目录、触发重载，而不是在 Sublime 里跑出游戏逻辑。
怎么确认 Lua 解释器已就位且 Sublime 能调到
这是所有后续操作的前提。终端里 lua -v 或 luajit -v 必须能输出版本号，否则 Sublime 的 Ctrl+B 必然失败。
- Windows：用
where lua查路径；若无输出，去 LuaBinaries 下lua-5.4.x_Win64_bin.zip，解压后把含lua.exe的目录加进系统 PATH - macOS：用
which lua；若为空，执行brew install lua@5.4（M1/M2 更稳），再记下实际路径（如/opt/homebrew/bin/lua） - Linux：
which lua5.4常比which lua有效；若命令名是lua5.4，构建文件里就得写["lua5.4", "$file"] - 改完 PATH 后必须彻底退出 Sublime（不是关窗口，要杀进程），否则它读不到新环境变量
为什么 Ctrl+B 没反应、也不报错
90% 是 .sublime-build 文件语法错了一个标点——Sublime 不提示，只静默忽略整个配置。
- 必须全用英文引号，不能有中文引号或全角符号
- 每行结尾加英文逗号（最后一项除外），多一个或少一个都会失效
- 缩进只能用空格，不能用 Tab；推荐统一 4 空格
-
"selector": "source.lua"是硬性要求：如果你装的是Lua Enhanced插件，它注册的是source.lua.enhanced，这里就必须同步改成该值 - 保存路径必须是
Packages/User/（可通过Preferences → Browse Packages…打开），文件名建议为Lua.sublime-build
游戏脚本需要热重载，不是本地执行
魔兽世界插件、Roblox 模块、Love2D 游戏逻辑——这些脚本依赖游戏引擎上下文，lua script.lua 在终端跑通了也没用，得让游戏重新加载。
- 魔兽向：构建系统用
"shell_cmd": "cp "$file" "~/Documents/Wow/Interface/AddOns/YourAddon/YourAddon.lua""，再配一个 variant 用 AppleScript 或 AutoHotkey 发/reload - Roblox 向：优先走
rojo build，构建内容设为"shell_cmd": "rojo build && echo '✅ Synced'"，确保rojo.json中servePort已开 - 别在构建系统里写
cd xxx && lua yyy—— Sublime 不解析 shell 语法，&&会直接导致失败 - 如果脚本里有
io.read()或等待输入，Sublime 输出面板不支持 stdin，此时必须切到终端手动运行
中文路径、空格路径、交互输入导致报错
典型错误如 cannot open xxx: No such file or directory，不是 Lua 问题，是路径编码错位或 shell 解析失败。
- Windows 上最常见：Sublime 默认用 GBK 读路径，而
lua.exe（尤其 5.4+）只认 UTF-8；最稳方案是把 .lua 文件移到纯英文路径下 - 路径含空格（如
C:Program Files）时，Windows 构建需写死带双引号的完整路径：[""C:\path\to\lua.exe"", "$file"] - macOS GUI 启动的 Sublime 可能读不到 shell 的 PATH，建议从终端启动：
subl，而非点击图标 -
file_regex要匹配实际报错格式：标准 Lua 是test.lua:5: attempt to call a nil value，Luajit 可能带列号:5:12，正则就得对应调整
真正卡住人的从来不是插件装没装对，而是解释器路径、JSON 标点、selector 绑定这三处细节没对齐；尤其是游戏开发场景，重点不在“运行 Lua”，而在“让游戏感知变更”。
