VSCode 中 Lua 项目配置本地第三方库的完整指南

在 Lua 开发过程中，尤其是使用 VSCode 进行编码时，经常会遇到这样一个问题：我已经下载好了第三方的 Lua 库，但是编辑器总是找不到它们，既没有智能提示，运行时也报错。这通常是因为 VSCode 的 Lua 插件没有正确识别这些库的路径。

今天我们就来聊聊如何把手头的本地第三方库完美地接入到你的 VSCode Lua 项目中。

为什么会出现这个问题？

首先我们要明白，Lua 本身是一门轻量级的语言，它的模块加载机制依赖于环境变量（如 LUA_PATH）。而在 VSCode 中，如果你安装了 Lua 语言服务器插件（比如 LuaLS 或 sumneko.lua），这些插件也有自己的一套路径扫描规则。如果你的本地库既不在系统的默认搜索路径里，也没有在项目配置中显式声明，编辑器自然就“瞎”了。

核心解决方案：配置 .luarc.json

目前最主流、最稳妥的解决方案是在项目根目录下建立一个 .luarc.json 文件。这是 Lua Language Server 的专用配置文件，它可以精确地告诉插件去哪里找你的代码。

第一步：确定库的位置

假设你的项目结构如下：

MyProject/
├── src/
│   └── main.lua
└── libs/
    └── mylib/
        └── init.lua

在这个例子中，libs 文件夹存放的就是你的第三方本地库。

第二步：创建 .luarc.json

在 MyProject 的根目录下新建一个文件，命名为 .luarc.json。注意，前面的点是必须的，这代表它是一个隐藏配置文件。

第三步：编写配置内容

我们需要在这个文件里配置 workspace.library。这是最关键的一步。请输入以下内容：

{
  "workspace.library": [
    "${3rd}/love2d/library",
    "./libs/"
  ]
}

这里的重点解释一下：

1. `