应安装sumneko官方Lua插件并配置runtime版本与全局变量；下载lua-debug适配器并配置launch.json；集成LÖVE类型声明文件并添加workspace库路径；最后通过tasks.json配置love运行任务实现保存即重载。
如果您在使用 Visual Studio Code 进行 Lua 游戏脚本开发时遇到语法高亮异常、调试无法启动或代码补全失效等问题，则可能是由于 Lua 扩展配置不完整或运行环境未正确集成。以下是针对该场景的多种解决路径：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并配置 Lua 插件
VSCode 本身不原生支持 Lua，需通过插件提供语法识别、智能提示与调试能力。推荐使用由 sumneko 维护的官方 Lua 插件，它基于 Language Server Protocol 实现稳定语言服务。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 Lua，找到名称为 Lua 的插件（发布者为 sumneko）。
3、点击“安装”，安装完成后重启 VSCode。
4、按下 Cmd+Shift+P，输入 Preferences: Open Settings (JSON)，在 settings.json 中添加以下配置：
"lua.runtime.version": "LuaJIT",
"lua.diagnostics.globals": ["love", "print", "io", "math"]
二、配置 Lua 调试器（Debug Adapter）
调试游戏脚本需依赖外部调试适配器，常见方案是使用 lua-debug，它兼容 LÖVE、Defold 等主流游戏框架，并支持断点、变量监视与调用栈查看。
1、访问 GitHub 仓库 https://github.com/actboy168/lua-debug，下载最新 release 中的 lua-debug.so（macOS）或 lua-debug.dll（Windows）文件。
2、将该文件放入项目根目录下的 .vscode/lua-debug/ 文件夹中（若不存在则手动创建）。
3、在项目根目录下创建 .vscode/launch.json，写入如下内容：
{
"version": "0.2.0",
"configurations": [
{
"type": "lua",
"request": "launch",
"name": "Launch Game Script",
"program": "${workspaceFolder}/main.lua",
"cwd": "${workspaceFolder}"
}
]
}
三、集成 LÖVE 框架运行时
LÖVE 是最常用的 Lua 游戏开发框架，VSCode 需明确识别其全局 API，否则会误报未定义函数错误。此步骤通过类型声明文件补充语义信息。
1、在项目根目录执行命令：mkdir -p .vscode && curl -o .vscode/love.lua https://raw.githubusercontent.com/EmmanuelOga/love-types/master/love.lua
2、在 settings.json 中添加：
"Lua.diagnostics.globals": ["love"],
"Lua.workspace.library": ["${workspaceFolder}/.vscode/love.lua"]
3、在任意 Lua 文件顶部添加注释：---@diagnostic disable: undefined-global（仅对当前文件临时禁用未定义全局变量警告）。
四、启用实时重载（Hot Reload）支持
游戏开发中频繁修改脚本后需手动重启应用，通过配置文件监听与自动执行可提升迭代效率。此方法依赖 VSCode 内置任务系统与 shell 命令组合。
1、在项目根目录创建 .vscode/tasks.json，内容如下：
{
"version": "2.0.0",
"tasks": [
{
"label": "run-love",
"type": "shell",
"command": "love .",
"isBackground": true,
"problemMatcher": []
}
]
}
2、按下 Cmd+Shift+P，输入 Tasks: Run Task，选择 run-love 启动游戏。
3、再按下 Cmd+Shift+P，输入 File: Save All，触发保存即重载逻辑（需配合 LÖVE 的 love.filesystem.setIdentity 与自定义 reload 函数实现）。
