需安装 Lua Helper 插件并配置 Lua 运行时路径、启用全局类型定义支持、设置 workspace 级配置，才能实现完整语法高亮、可靠跳转与智能提示。
如果您在使用 VSCode 进行 Lua 开发时发现语法高亮不完整、跳转不可靠或缺少智能提示，则可能是由于默认语言支持未启用高级分析能力。以下是为 VSCode 配置 Lua Helper 插件并启用增强开发支持的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Lua Helper 扩展
Lua Helper 是一个专为 Lua 语言设计的 VSCode 扩展，提供符号跳转、类型推导、代码补全与错误诊断等核心功能。它依赖于本地 Lua 解析器，需配合 Lua 环境协同工作。
1、打开 VSCode，点击左侧活动栏中的扩展图标（方块拼图形状）。
2、在扩展搜索框中输入 Lua Helper，确认发布者为 koihik。
3、点击“安装”按钮，等待安装完成。
4、安装完毕后点击“重新加载”以激活插件。
二、配置 Lua 运行时路径
Lua Helper 需要明确识别当前项目所用的 Lua 解释器版本，以便准确解析语法结构和标准库定义。若未指定路径，部分语义功能将无法启用。
1、按下 Cmd + , 打开设置界面。
2、在右上角搜索框中输入 lua.runtime.version。
3、点击“在 settings.json 中编辑”，在 JSON 文件中添加如下字段：
"lua.runtime.version": "5.4"
4、若项目使用自定义 Lua 可执行文件，还需设置 lua.runtime.path，值为绝对路径，例如 /usr/local/bin/lua。
三、启用全局类型定义支持
Lua Helper 支持通过 LuaDoc 注释与类型声明文件（.d.lua）实现类型感知。启用该功能可显著提升函数参数提示与返回值推断准确性。
1、在项目根目录下创建 luadoc.d.lua 文件。
2、在该文件中添加基础类型声明，例如：
采用 php+mysql 数据库方式运行的强大网上商店系统，执行效率高速度快，支持多语言，模板和代码分离，轻松创建属于自己的个性化用户界面 v3.5更新： 1).进一步静态化了活动商品. 2).提供了一些重要UFT-8转换文件 3).修复了除了网银在线支付其它支付显示错误的问题. 4).修改了LOGO广告管理,增加LOGO链接后主页LOGO路径错误的问题 5).修改了公告无法发布的问题,可能是打压
declare global {
function print(...: any): nil
}
3、在 VSCode 设置中搜索 lua.suggest.autoImport，将其设为 true。
4、重启 VSCode 窗口使类型定义生效。
四、配置 workspace 文件夹级设置
针对多 Lua 版本共存或跨平台协作项目，需在 .vscode/settings.json 中为当前工作区单独设定解析行为，避免全局配置冲突。
1、在项目根目录下创建 .vscode 文件夹（若不存在）。
2、在其中新建 settings.json 文件。
3、写入以下内容：
{
"lua.diagnostics.globals": ["package", "string", "table"],
"lua.suggest.enableServer": true
}
4、保存后，Lua Helper 将仅依据该 workspace 的规则执行诊断与建议。
