模块与包

Lua 提供了简洁的 模块化机制，便于将代码拆分为独立文件和逻辑单元，

通过 require 可以方便地导入和复用模块。

🧩 创建模块

假设我们创建一个模块文件 math_utils.lua：

-- math_utils.lua
local M = {}

function M.add(a, b)
  return a + b
end

function M.sub(a, b)
  return a - b
end

return M

模块内部通常使用局部表 M 保存函数，最后 return M 导出。

在主程序中使用 require 导入模块：

local math_utils = require("math_utils")

print(math_utils.add(3, 5))  -- 输出 8
print(math_utils.sub(10, 4)) -- 输出 6

Lua 根据 package.path 搜索模块文件：

print(package.path)

默认路径中使用 ? 占位符匹配模块名，例如：

./?.lua; /usr/local/share/lua/5.4/?.lua; ...

如果模块在其他目录，可通过修改 package.path 或将模块放到标准路径中。

模块可以嵌套形成命名空间：

-- utils/string_utils.lua
local M = {}

function M.upper(str)
  return string.upper(str)
end

return M

local string_utils = require("utils.string_utils")
print(string_utils.upper("lua"))  -- LUA

模块也可以直接返回函数，适用于单一功能模块：

-- square.lua
return function(x)
  return x * x
end

local square = require("square")
print(square(5))  -- 25