配置Lua语言服务器可提升VSCode开发体验，首先安装LuaLS扩展以获得智能补全、语法检查等功能，然后在项目根目录创建settings.json文件并设置runtime版本、路径、诊断和补全选项，若使用框架可添加API路径至workspace.library，最后通过功能测试验证配置是否成功。
想在 VSCode 中高效编写 Lua 代码，配置一个语言服务器是关键。通过语言服务器（Lua LS），你能获得智能补全、语法检查、函数跳转、参数提示等现代化开发功能。下面是如何一步步配置 Lua 开发环境的实用指南。
安装 Lua 语言服务器
VSCode 本身不内置 Lua 支持，需要借助扩展和语言服务器实现。目前最推荐的是 emmylua-ls 或 sumneko lua（现由 LuaLS 维护）。
- 打开 VSCode 扩展市场，搜索 “Lua”
- 安装官方推荐或评分高的 Lua 扩展，例如 “Lua” by tupini07（即 LuaLS）
- 该扩展会自动下载并管理对应的语言服务器，无需手动编译
安装完成后，当你打开 .lua 文件时，语言服务器会自动启动，底部状态栏可能显示“Lua: Running”提示。
基础配置示例
为了让语言服务器更好工作，建议在项目根目录创建 .vscode/settings.json 文件进行配置。
示例配置：{
"lua.runtime.version": "LuaJIT", // 根据你用的是 Lua 5.1/5.3/5.4 或 LuaJIT 选择
"lua.runtime.path": [
"?;?.lua;?/init.lua",
"?/?.lua;?/?/init.lua"
],
"lua.diagnostics.enable": true, // 启用语法错误检查
"lua.completion.enable": true, // 启用自动补全
"lua.workspace.library": [
"${env:HOME}/.luarocks/share/lua/5.1" // 若使用 luarocks，可加入路径
],
"lua.workspace.preloadFileSize": 2000 // 大文件加载限制（KB）
}
如果你在使用 Love2D、Defold 或自定义框架，可以将框架 API 路径加入 workspace.library，让补全更准确。
验证是否配置成功
配置完成后，打开任意 .lua 文件测试以下功能：
- 输入函数名时是否有参数提示
- 按 Ctrl+点击 是否能跳转到函数定义
- 拼写错误是否被波浪线标出
- 输入 table. 是否列出可用字段
如果这些功能正常，说明语言服务器已正确运行。若出现问题，可打开 VSCode 的输出面板，选择 “Lua” 查看服务器日志。
可选：本地编译语言服务器（高级）
如果你希望使用最新版本或自定义功能，可以从源码构建 Lua 语言服务器。
- 项目地址通常为 GitHub 上的 LuaLS/lua-language-server
- 克隆后根据文档编译（支持 Windows、macOS、Linux）
- 在 settings.json 中指定 lua.command.path 指向你的可执行文件
这种方式适合有特殊需求的开发者，普通用户建议直接使用扩展自带版本。
基本上就这些。配置一次后，后续项目都能复用，Lua 开发体验会大幅提升。
