Lua 的 Package 模块 是 Lua 标准库中用于管理模块加载和依赖关系的重要组件。它提供了一套完整的机制来帮助开发者组织和管理代码模块。
核心功能
模块加载机制：
- 通过
require函数加载模块 - 自动处理模块路径搜索（
package.path和package.cpath） - 支持缓存已加载模块（
package.loaded表）
- 通过
模块搜索路径：
- Lua 模块路径存储在
package.path中 - C 模块路径存储在
package.cpath中 - 路径使用分号分隔，支持模板变量（如
?会被替换为模块名）
- Lua 模块路径存储在
模块缓存：
- 所有已加载模块存储在
package.loaded表中 - 避免重复加载同一个模块
- 可以通过设置
package.loaded[modname] = nil强制重新加载
- 所有已加载模块存储在
典型使用示例
-- 加载模块localmath=require("math")-- 自定义模块localmymodule={}functionmymodule.add(a,b)returna+bendreturnmymodule-- 加载自定义模块localmymod=require("mymodule")print(mymod.add(1,2))-- 输出 3高级功能
搜索器（Searchers）：
package.searchers表定义了模块搜索策略- 默认包含 4 种搜索器（Lua 文件、C 文件、all-in-one 加载器等）
- 可以自定义搜索器来实现特殊的模块加载逻辑
预加载（Preload）：
package.preload表可以预先定义模块加载器- 适用于需要特殊初始化的模块
路径管理：
- 运行时可以修改
package.path和package.cpath - 适合需要动态调整模块搜索路径的场景
- 运行时可以修改
应用场景
- 插件系统：通过动态修改
package.path实现插件加载 - 热更新：通过清除
package.loaded缓存实现模块重载 - 跨平台开发：根据平台调整
package.cpath加载正确的二进制模块
注意事项
- 模块命名应避免与标准库冲突
- 循环依赖可能导致加载失败
- 路径中的斜杠方向应注意平台兼容性（Windows 用
\，Unix 用/）
通过合理使用 Package 模块，可以构建出结构清晰、易于维护的 Lua 项目。
