sublime text 需配置系统级 lua 解释器、自定义 utf-8 编码的 build system、安装 luaenhanced 与 sublimelinter-lua 插件，并手动重载构建系统才能实现高效 lua 开发。
Sublime Text 本身不内置 Lua 支持，但能通过插件和自定义 Build System 实现高效 Lua 开发——关键不是装“Lua 插件”，而是让 lua 命令可执行、构建配置指向正确解释器、并解决路径和编码常见问题。
确认系统已安装 Lua 并可在终端运行 lua
Sublime 的 Build System 本质是调用系统命令，如果终端里输 lua -v 报 “command not found”，任何配置都无效。
- macOS：推荐用
brew install lua（装的是 Lua 5.4+），避免用系统自带的过时 Lua 5.2 - Windows：下载官方二进制（如
lua-5.4.6_Win64_bin.zip），解压后把lua.exe所在目录加进系统PATH环境变量 - Linux：多数发行版用
sudo apt install lua5.4或sudo yum install lua，注意检查是否安装了lua而非仅liblua - 验证方式：打开终端（或 CMD/PowerShell），执行
lua -v和which lua（macOS/Linux）或where lua（Windows）
创建正确的 Lua Build System（支持中文路径与 UTF-8）
默认的 Tools → Build System → New Build System… 模板需手动适配，否则中文路径会报错 cannot open script file，或输出乱码。
- 新建 Build 文件后，粘贴以下内容（适配 macOS/Linux；Windows 用户把
"cmd": ["lua", "$file"]改为"cmd": ["lua.exe", "$file"]）：
{
"shell_cmd": "lua \"$file\"",
"file_regex": "^(...*?):([0-9]*):?([0-9]*):? (.*)$",
"selector": "source.lua",
"encoding": "UTF-8",
"variants": [
{
"name": "Run with Args",
"shell_cmd": "lua \"$file\" $args"
}
]
}
-
"shell_cmd"用双引号包裹$file，防止路径含空格或中文时报错 -
"encoding": "UTF-8"必须显式声明，否则 Windows 下读取含中文的 Lua 文件会崩溃 -
"file_regex"用于点击错误跳转行号，正则匹配标准 Lua 错误格式（如test.lua:5: attempt to call a nil value）
推荐必装插件：LuaEnhanced + SublimeLinter-lua
单纯语法高亮用内置 Lua 语法即可，但真正提升开发效率的是语义支持和实时检查。
-
LuaEnhanced：替代老旧的lua-sublime，提供准确的语法着色、goto definition、参数提示（基于lua-language-server） -
SublimeLinter-lua：需先npm install -g luacheck，再配置 linter 路径指向luacheck可执行文件，实现保存即检错 - 注意：不要同时启用
Lua（旧版）和LuaEnhanced，冲突会导致语法识别异常 - 插件安装后，右下角状态栏应显示
LuaEnhanced，而非Lua
最易被忽略的是：Sublime 不会自动重载 Build System 修改，改完 .sublime-build 文件后必须重启 Sublime 或手动 Tools → Build System → [你的 Build 名] 切换一次才生效；另外，如果 Lua 脚本依赖本地模块（比如 require "mylib"），LUA_PATH 环境变量不会被 Build System 继承，此时需在 Build 配置中用 "env": {"LUA_PATH": "./?.lua;./?/init.lua"} 显式传入。
