sublime text 配置 lua 环境需三步：正确绑定 lua 语法（右下角选 lua 或 luaenhanced）、确保系统已安装并可调用 lua/lua5.4/luajit（终端执行 lua -v 验证）、编写无误的 lua.sublime-build 文件（含 "cmd"、"selector"、"file_regex" 且 json 格式严格正确）。
Sublime Text 本身不运行 Lua，也不自带语法支持；所谓“配置环境”，本质是三件事：让 .lua 文件正确高亮、让 Ctrl+B 能调用系统里的 lua 或 luajit、让错误信息可点击跳转。90% 的失败不是插件装错了，而是解释器没装好、PATH 没生效、或构建文件 JSON 写错一个标点。
怎么让 .lua 文件一打开就有语法高亮和括号匹配
右下角显示 “Plain Text” 就说明没绑定语言——这不是 bug，是 Sublime 压根没加载 Lua 语法定义。最简路径是：
打开任意 .lua 文件 → 点右下角语言名 → 选 Lua（不是 LuaEnhanced，也不是 LuaLanguage）。这会把所有同后缀文件自动绑定到内置 Lua 包。
如果列表里没有 Lua，说明内置包缺失，需装插件：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入
Package Control: Install Package回车 - 搜
Lua Enhanced并安装（它比原生包支持更全，含require跳转、注释折叠、do/end匹配） - 装完后重开文件，右下角应显示
Lua Enhanced
别装名字带 sublime 或 lua-completion 的废弃包，容易冲突；也别依赖自动检测——某些游戏脚本（如魔兽插件）会被误判为纯 Lua，得手动右键 → Set Syntax → Lua Enhanced。
为什么 Ctrl+B 报 lua: command not found
这个报错和插件完全无关，只说明 Sublime 构建系统找不到 lua 命令。它不读你 shell 的 PATH，尤其 macOS GUI 启动时根本看不到 brew 装的路径。
- 先在终端执行
lua -v：能输出类似Lua 5.4.6才算通过；Windows 用where lua，macOS/Linux 用which lua或which lua5.4 - Windows 常见坑：
lua.exe在C:\lua\，但没加进系统 PATH；或路径含空格（如C:\Program Files\Lua\），得在构建文件里写成["C:/lua/lua.exe", "$file"] - macOS GUI 启动的 Sublime 可能读不到
brew路径（比如/opt/homebrew/bin/lua），就得在.sublime-build里写死绝对路径 - Linux 很多发行版默认命令是
lua5.4而非lua，"cmd"字段必须跟which lua5.4输出严格一致
改完 PATH 后务必彻底退出 Sublime（不是关窗口，要杀进程），否则它启动时只读一次环境变量。
怎么写对 Lua.sublime-build 文件
这个 JSON 文件容错率极低：多一个逗号、引号用了中文、缩进混用 Tab，都会静默失效（Ctrl+B 没反应，也不报错）。
-
"cmd": ["lua", "$file"]是最简有效形式；别用"shell_cmd"（如"shell_cmd": "lua \"$file\""），Windows 下易因引号嵌套失败 -
"selector": "source.lua"是硬性要求——缺了它，Sublime 根本不会为.lua文件启用该构建系统；如果你装了Lua Enhanced，它注册的是source.lua.enhanced，这里就得同步改成对应值 -
"file_regex": "^(*?):([0-9]+):?([0-9]*):? (.*)$"用来匹配 Lua 默认错误格式（如test.lua:5: attempt to call a nil value）；若用luajit，错误末尾可能带列号（如:5:12），就得改成"^(.*?):([0-9]+):([0-9]+):" - 不要写
"working_dir": "$file_path"以外的路径逻辑；cd $file_path && lua $file_name这类 shell 语法在构建系统里直接失败
保存后，菜单栏 → Tools → Build System → Lua 必须被选中；右下角状态栏也要确认显示的是 Lua 或 Lua Enhanced，否则构建系统压根不触发。
游戏开发中容易被忽略的兼容性细节
很多老游戏引擎（如 Love2D 11.x、魔兽世界插件、Roblox Luau 子集）依赖特定 Lua 版本或扩展 API，光能跑 print("hello") 不代表环境就对了。
- Love2D 11.x 只认 Lua 5.1，
brew install lua默认装 5.4，得手动brew install lua@5.1并在构建文件里写死路径 - 魔兽插件常用
GetCVar、UnitName等全局函数，原生 Lua 语法包不识别，得靠Lua Enhanced配合自定义 API 补全配置 - Roblox 使用 Luau（Lua 超集），部分语法（如类型标注、
continue）在标准lua-language-server下会误报错，需额外配置luau-lsp - 热重载不是 Sublime 的事：魔兽需写入
Interface/AddOns/YourAddon/并执行/reload；Roblox 需用rojo同步到src/目录——构建系统只能帮你调用这些工具，不能替代它们
真正卡住人的从来不是“怎么装插件”，而是终端里 lua -v 是否成功、.sublime-build 里 "cmd" 是否指向真实可用的二进制、以及游戏引擎是否真的在读你写的那个文件路径。
