Sublime Text需安装插件实现Lua语法高亮和代码提示:语法高亮通过Package Control安装salsify维护的Lua包;基础补全用LuaComplete;进阶语义功能需配置SublimeLSP与lua-language-server。

Sublime Text 默认不支持 Lua 的完整语法高亮和智能提示,需手动安装插件并配置。核心是两个部分:语法高亮靠 Package Control 安装 Lua 语法包;代码提示(补全)依赖 LuaComplete 或更现代的 SublimeLSP + lua-language-server 方案。
安装 Lua 语法高亮支持
Sublime 默认识别 .lua 文件但高亮较简陋。推荐使用社区维护的 Lua 语法包(由 salsify 维护,比内置更准确):
- 按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),打开命令面板
- 输入 Install Package,回车,等待 Package Control 加载完成
- 再输入 Lua,选择并安装 Lua(作者:salsify)
- 安装后,打开 .lua 文件,右下角状态栏应显示 Lua(而非 Plain Text)。若未自动切换,点击状态栏语言名 → Open all with current extension as... → 选 Lua
启用基础代码补全(无需 LSP)
如果只需要函数名、关键字、标准库表(如 string.、table.)的简单提示,可安装轻量插件:
- 用 Package Control 安装 LuaComplete(注意:不是 Lua Completions)
- 安装后重启 Sublime,新建或打开 .lua 文件即可触发基础补全(如输入
stri后按 Ctrl+Space) - 该插件自带常用全局变量和标准库定义,无需额外配置,适合快速脚本开发
进阶:配置 LSP 实现真正语义级提示
要获得类型推导、跳转定义、悬停文档、错误实时标记等 IDE 级功能,需搭配 lua-language-server:
- 先安装 lua-language-server:推荐用 官方 Release 下载对应平台二进制,解压后记下完整路径(如
/opt/lua-language-server/bin/lua-language-server) - 用 Package Control 安装 SublimeLSP 和 SublimeLSP-lua(后者为 Lua 专用客户端配置)
- 进入 Preferences → Package Settings → LSP → Settings,在用户设置中添加:
{
"clients": {
"lua-language-server": {
"command": ["/your/path/to/lua-language-server", "-E"],
"enabled": true,
"initializationOptions": {
"diagnostics": {
"enable": true
}
},
"scopes": ["source.lua"],
"syntaxes": ["Packages/Lua/Lua.sublime-syntax"],
"languageId": "lua"
}
}
}
保存后重启,打开 .lua 文件,状态栏左下角出现 LSP 即表示已连接成功。
小技巧与常见问题
避免踩坑,注意以下几点:
- 确保文件扩展名为 .lua,且右下角显示语言为 Lua(不是 Lua (Luajit) 或其他变体)
- 若 LSP 不生效,检查终端执行
/path/to/lua-language-server --version是否能正常输出版本号 - 项目有
luarc.json配置时(如指定runtime.version或workspace.library),LSP 会自动读取,用于适配不同 Lua 版本或加载自定义模块 - 不想全局启用 LSP?可在项目根目录建
.sublime-project,在settings中加"lsp_disabled_servers": ["lua-language-server"]
基本上就这些。语法高亮开箱即用,代码提示按需升级——简单脚本用 LuaComplete 足够,工程级项目建议上 LSP。










