VS Code安装sumneko Lua扩展后自动补全、运行功能失效如何解决

1. 基础前置检查 #

• 确认本地已安装Lua运行环境：sumneko扩展本身不内置Lua解释器，需自行安装并添加到系统环境变量。可在终端执行lua -v验证，正常输出版本号即为配置完成。
• 确认扩展已正常启用：打开VS Code扩展面板，搜索Lua（sumneko扩展现官方名称为Lua by sumneko），确认状态为已启用，无兼容报错提示。
• 确认当前打开的是.lua后缀文件：扩展的语法识别、补全功能默认仅对Lua后缀文件生效。

2. 核心功能配置 #

自动补全失效排查 #

• 检查工作区Lua版本配置：打开VS Code设置，搜索Lua.runtime.version，选择和你本地安装一致的Lua版本（如5.1、5.4等），版本不匹配会导致补全逻辑异常。
• 检查工作区库路径配置：如果是包含第三方依赖的项目，需在设置中Lua.workspace.library项添加依赖库的本地路径，扩展才会识别第三方库的API提供补全。
• 排除其他插件冲突：临时禁用其他Lua相关扩展，重启VS Code验证是否为插件冲突导致补全失效。

代码执行功能失效排查 #

sumneko扩展本身不自带代码运行能力，代码执行需额外配置运行任务或配合Code Runner等运行类扩展

• 若使用Code Runner扩展：打开设置搜索code-runner.executorMap，找到lua对应的配置项，确认值为你的Lua解释器本地路径，示例配置："lua": "lua"（环境变量配置正常的情况下）
• 若使用VS Code内置任务：需在工作区.vscode/tasks.json中配置Lua运行任务，最小配置示例：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "运行Lua文件",
            "type": "shell",
            "command": "lua ${file}",
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

• 验证配置后，按快捷键Ctrl+Shift+B（Windows/Linux）或Command+Shift+B（Mac）即可执行当前Lua文件。

3. 最终验证 #

完成上述配置后，重启VS Code，新建后缀为.lua的测试文件，输入print观察是否有补全提示，运行文件观察是否正常输出结果。

内容的提问来源于stack exchange，提问作者user977828