VSCode是游戏开发中高效、可扩展且支持智能提示与调试的Lua开发平台。需安装sumneko Lua插件、配置lua-language-server路径、创建.luarc.json声明Lua版本与全局变量，并通过Lua Debug扩展及launch.json集成引擎调试。
如果您在游戏开发中使用lua脚本，但缺乏高效、可扩展且具备智能提示与调试能力的编辑环境，则vscode凭借其轻量性、插件生态与深度定制能力，成为实际项目中广泛采用的lua开发平台。以下是围绕vscode开展lua脚本开发的关键配置与实践方式：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装Lua语言支持插件
VSCode本身不原生支持Lua语法识别与智能补全，需通过官方推荐的语言服务器协议（LSP）插件实现完整语言功能。核心依赖为Lua语言服务器（lua-language-server），配合VSCode插件提供语法高亮、跳转定义、错误检查等能力。
1、打开VSCode，点击左侧活动栏的扩展图标（或按快捷键Ctrl+Shift+X）。
2、在搜索框中输入Lua，找到由sumneko发布的Lua插件（图标为蓝色“L”字母）。
3、点击安装，安装完成后重启VSCode。
二、配置lua-language-server运行路径
插件需调用本地安装的lua-language-server二进制文件才能启动语言服务。该服务器可独立安装，也可通过包管理器获取，确保VSCode能准确定位其可执行路径。
1、在终端中执行命令：brew install lua-language-server（macOS用户）。
2、执行命令：which lua-language-server，记录输出路径（如/usr/local/bin/lua-language-server）。
3、进入VSCode设置（Cmd+,），搜索lua.runtime.path，在设置项“Lua: Runtime Path”中粘贴上一步获取的路径。
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...
三、配置Lua项目根目录与版本兼容性
lua-language-server需明确项目使用的Lua运行时版本及标准库路径，否则可能出现类型推断错误或全局变量未识别问题。尤其在游戏引擎（如Love2D、Defold、Cocos Creator）中，Lua运行环境常基于5.1/5.3/5.4定制，必须显式声明。
1、在项目根目录下创建文件.luarc.json。
2、写入内容：{"runtime.version": "Lua 5.3", "diagnostics.globals": ["love", "cc"]}（以Love2D为例，将love加入全局变量白名单）。
3、保存后，VSCode会自动重载语言服务器配置，错误提示与自动补全立即生效。
四、集成游戏引擎调试支持
纯编辑无法满足真实开发需求，需将VSCode与游戏引擎的调试端口对接，实现断点、变量监视与单步执行。不同引擎适配方式不同，但均依赖调试器扩展与launch.json配置。
1、安装扩展：Lua Debug（由actboy168发布）。
2、在项目根目录创建.vscode/launch.json文件。
3、填入适配Love2D的配置段：{"type": "lua", "request": "attach", "name": "Love2D Debug", "port": 8080, "host": "127.0.0.1"}。
4、启动Love2D时添加参数：love --debug，使引擎监听调试端口。
