sublime text本身不运行lua，仅通过构建系统调用系统已安装的lua/luajit；配置核心是安装lua enhanced插件实现语法高亮，并严格按json规范创建lua.sublime-build文件，确保selector、cmd路径、编码及保存位置正确。
Sublime Text 本身不运行 Lua，也不提供游戏开发专用功能；所谓“插件推荐”，实际只有两类东西真正起作用：一类管编辑体验（比如高亮、跳转），另一类管构建和集成（靠 .sublime-build 文件，不是插件）。装一堆名字带“lua”“sublime”的包，大概率白忙活。
怎么让 .lua 文件有基础编辑能力
默认打开 .lua 文件是 Plain Text，括号不匹配、关键字不着色、缩进全乱——这不是配置错了，是 Sublime 根本没加载任何 Lua 语法定义。
- 最简操作：打开任意
.lua文件 → 点右下角语言名（如 “Plain Text”）→ 选Lua（如果列表里有） - 若没有
Lua选项，说明内置包缺失，需装Lua Enhanced：按Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜Lua Enhanced安装 - 装完后重开文件，右下角应显示
Lua Enhanced；别装lua-sublime或sublime-lua这类废弃包，容易冲突
Ctrl+B 报 lua: command not found 怎么办
这个错误和插件完全无关，只说明 Sublime 构建系统找不到 lua 命令——它根本没去查你装了什么插件，只查系统 PATH。
- 先在终端执行
lua -v（或luajit -v）：能输出版本号才算通过 - Windows 常见坑：
lua.exe在C:\lua\，但没加进系统 PATH；或者路径含空格（如C:\Program Files\Lua\），得在构建文件里写成["C:/lua/lua.exe", "$file"] - macOS GUI 启动的 Sublime 可能读不到 shell 的 PATH（比如
brew install lua装在/opt/homebrew/bin/lua），就得在.sublime-build里写死绝对路径 - Linux 很多发行版默认命令是
lua5.4而非lua，"cmd"字段必须跟which lua5.4输出一致
游戏开发中真正有用的构建配置（Roblox / Love2D / 魔兽插件）
游戏脚本不能用本地 lua 直接跑——那只是个空壳解释器，没游戏上下文。不同引擎要配不同的构建逻辑，不是换行命令那么简单。
- Roblox 向：优先用
rojo build，确保rojo.json中servePort开启，构建系统设为：{"shell_cmd":"rojo build && echo '✅ Synced to Roblox Studio'", "working_dir":"${project_path:${folder}}"} - Love2D 向：别用
lua main.lua，得用love .；构建系统里"cmd"应为["love", "."]，且"working_dir"必须设为"$file_path" - 魔兽插件向：通常依赖
WowLua或自研加载器，构建系统本质是触发 reload，例如：{"shell_cmd":"echo 'Reloading WoW addon...'; osascript -e 'tell application \"World of Warcraft\" to activate'"}（macOS） - 所有游戏场景下，都别用
"shell_cmd": "cd $file_path && lua $file_name"—— Sublime 构建系统不支持&&和cd，会静默失败
Lua.sublime-build 文件为什么保存了却没反应
JSON 格式容错率极低，一个标点错就静默失效：Ctrl+B 没反应，也不报错。这不是插件问题，是 Sublime 直接忽略整个文件。
-
"selector": "source.lua"是硬性要求——缺了它，Sublime 根本不会为.lua文件启用该构建系统；如果你装的是Lua Enhanced，它注册的是source.lua.enhanced，这里也得同步改成对应值 - 必须用英文引号，末尾逗号不能少，缩进必须是 4 个空格（别用 Tab）
-
"file_regex"决定错误点击能否跳转：Lua 默认报错格式是test.lua:5: attempt to call a nil value，正则推荐"^(*?):([0-9]+):?([0-9]*):? (.*)$"；若用luajit且带列号（如:5:12），得改成"^(.*?):([0-9]+):([0-9]+):" - 文件必须存到
Packages/User/目录下（可通过Preferences → Browse Packages…打开），后缀必须是.sublime-build
最容易被忽略的其实是工作目录和编码：中文路径、空格路径在 Windows 上极易触发 cannot open xxx: No such file or directory，因为 Sublime 用 ANSI 编码读路径，而 Lua 5.4+ 只认 UTF-8；最稳方案是把脚本全放纯英文路径下，比如 C:/game-dev/roblox/hello.lua。
