include作用
🤖 回答引擎: 后端Lua |
🕒 时间: 2026-03-25 11:13:49 |
👁️ 阅读: 2
后端Lua尊者：我是lua后端老师！
`include` 是996引擎Lua脚本中的一个核心函数，它的主要作用是**加载并执行其他Lua脚本文件**。这相当于把另一个文件里的代码“合并”到你当前正在编写的脚本中，是实现代码模块化、复用和管理的关键手段。
简单来说，它有两个核心功能：
1. **引入外部代码**：让你可以把常用的功能（比如配置表、工具函数、网络协议定义）写在单独的文件里，然后在需要的地方用 `include` 调用，避免重复编写。
2. **获取返回值**：被 `include` 的文件如果最后有 `return` 语句返回一个值（通常是表 `table`），那么 `include` 函数本身就会把这个值返回给你，方便你直接使用。
---
### 具体用法和示例
根据知识库，`include` 函数接受一个参数：
* **`path` (字符串，必填)**：要加载的Lua文件的路径。**注意，这个路径的起始目录是引擎的 `Envir` 文件夹**。
**示例1：加载配置，并使用返回值**
假设你有一个网络消息的配置文件 `NetMsgCfg.lua`，路径是 `Envir/QuestDiary/net/NetMsgCfg.lua`。
```lua
-- 在你的主脚本（比如 QManage.lua）中这样使用：
-- 使用 include 加载文件，并将文件返回的表赋值给一个变量
local ssrNetMsgCfg = include("QuestDiary/net/NetMsgCfg.lua")
function login(actor)
-- 现在可以直接使用引入的配置了
release_print("VIP等级响应协议号是:", ssrNetMsgCfg.main_VipLevelResponse)
end
```
```lua
-- 被加载的文件 NetMsgCfg.lua 内容：
local ssrNetMsgCfg = {
init = 10,
main = "main",
main_VipLevelResponse = 100, -- VIP等级响应协议号
}
-- 关键：最后 return 这个表，这样 include 才能拿到它
return ssrNetMsgCfg
```
**示例2：单纯执行代码**
如果被加载的文件没有 `return`，或者你不关心返回值，`include` 也会执行其中的所有代码。
```lua
-- 假设有个工具文件 `utils.lua`
include("QuestDiary/脚本/utils.lua")
-- 执行完这行后，utils.lua 里定义的全局函数或变量就可以在当前脚本中使用了
```
---
### 重要提示（接地气版）
1. **起始路径**：小仙们切记！`include` 找文件是从 `Envir` 文件夹开始的。如果你的文件在 `Envir/QuestDiary/系统`，参数就写 `"QuestDiary/系统/文件名.lua"`。
2. **和 `require` 的区别**：知识库里也提到了 `require`，它也是加载文件，但查找路径的规则可能和 `include` 稍有不同。在996引擎环境下，通常更推荐使用 `include`，因为它更贴合引擎的目录结构。
3. **代码整洁**：多用 `include` 把功能分到不同文件，你的 `QManage.lua` 才不会变成几万行的“屎山代码”，后期维护和修仙（调试）起来会轻松很多！
4. **错误处理**：如果文件路径写错了，引擎会报错。修仙者们要仔细检查路径和文件名哦。
如果还有不明白的，随时可以问我，或者请教我的师傅 **浮生梦** 尊师！
← 返回问答库