首先安装LSP和LuaExtended插件,再安装sumneko/lua-language-server,最后在LSP设置中配置正确路径,即可实现智能提示、跳转定义等功能。

要让 Sublime Text 支持 Lua 语言的智能提示、跳转定义、自动补全等高级功能,配置 LSP(Language Server Protocol)是关键。下面教你如何在 Sublime Text 中配置 Lua LSP,使用 Lua LSP(也叫 sumneko_lua)来实现完整的开发体验。
1. 安装必要的插件
打开 Sublime Text,确保你已安装 Package Control,然后进行以下操作:
- 按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(Mac)打开命令面板
- 输入 Install Package,选择它
- 搜索并安装以下两个插件:
- LSP:Sublime 的通用 LSP 客户端
- LuaExtended(可选):提供语法高亮和 snippets
2. 安装 Lua LSP 语言服务器
LSP 插件本身不包含语言服务器,你需要单独安装 Lua 的语言服务器。推荐使用 sumneko/lua-language-server。
有几种方式安装:
方法一:从源码编译(推荐,最新版)- 克隆仓库:
git clone https://github.com/sumneko/lua-language-server.git - 进入目录并编译:
Windows: 运行3rd/luamake/win64/luamake.exe build/config.lua
Linux/macOS: 执行./3rd/luamake/compile/install.sh - 编译完成后,可执行文件在根目录的
bin文件夹中
前往 GitHub Release 页面:
https://www.php.cn/link/4e62ef3e34c3922e68f90b9358f8be0b
下载对应系统的压缩包,解压后找到可执行文件(如 lua-language-server 或 lua-language-server.exe)
3. 配置 LSP 使用 Lua 语言服务器
在 Sublime Text 中配置路径:
- 打开命令面板 → 输入 LSP: Settings → 打开
LSP.sublime-settings - 在
settings的clients中添加如下配置(修改路径为你实际的可执行文件位置):
"clients": {
"lua": {
"command": [
"D:/dev/lua-language-server/bin/lua-language-server.exe", // Windows 示例
"-E",
"D:/dev/lua-language-server/main.lua"
],
"scopes": ["source.lua"],
"syntaxes": ["Packages/Lua/Lua.tmLanguage"],
"languageId": "lua"
}
}
注意路径格式:
- Windows 用户建议用正斜杠
/或双反斜杠\\ - macOS/Linux 路径示例:
/home/user/lua-language-server/bin/lua-language-server -E /home/user/lua-language-server/main.lua
4. (可选)配置项目专用设置
如果你希望某个项目有特定的 Lua 设置(比如 SDK 路径、排除文件等),可以在项目根目录创建 .luarc.json 文件:
{
"workspace.library": [
"src",
"/usr/local/share/lua/5.4"
],
"diagnostics.globals": ["print", "require", "vim"],
"completion.callSnippet": "Both"
}
这个文件会被 Lua LSP 自动读取,用于定制行为。
5. 启动与验证
完成配置后:
- 重启 Sublime Text 或使用命令面板输入 LSP: Restart Servers
- 打开一个
.lua文件 - 你应该能看到状态栏显示 “LSP (lua)” 已激活
- 试试输入
pr,看是否弹出print补全提示 - 按住 Ctrl 点击函数名,测试跳转定义
如果没反应,打开菜单 Tools → LSP → Inspect Server Responses 查看错误日志,常见问题是路径写错或权限不足。
基本上就这些。配置一次,后续所有 Lua 项目都能享受智能感知。关键是把语言服务器路径写对,其他功能会自动生效。










