登录深入Lua包（Package）与依赖管理
一、包的目录结构与require
require 函数天生就能理解目录结构。它通过点（.）来代表目录分隔符。
假设我们有这样一个项目结构：
/my_app
├── main.lua
└── /geometry <-- 这是一个包
├── shape.lua
└── transform.lua
shape.lua:
local M = {}
function M.new_circle(radius) return { type = 'circle', r = radius, x = 0, y = 0 } end
return M
transform.lua:
local M = {}
function M.move(shape, dx, dy)
shape.x = shape.x + dx
shape.y = shape.y + dy
return shape
end
return M
在 main.lua 中，我们可以轻松地加载这个包里的模块：
-- main.lua
-- 加载 geometry 包中的 shape 模块
local Shape = require("geometry.shape")
-- 加载 geometry 包中的 transform 模块
local Transform = require("geometry.transform")
-- 现在可以使用它们的功能
local circle = Shape.new_circle(10)
local moved_circle = Transform.move(circle, 5, 5)
print("圆形位置:", moved_circle.x, moved_circle.y)
二、包的核心入口：init.lua 文件
当我们无法或者不需要理解包内部结构时，就需要 init.lua 来导出外部需要的接口。当 require 一个目录时，Lua 会自动寻找并加载该目录下的 init.lua 文件。
让我们来改造一下上面的 geometry 包：
目录结构：
/my_app
├── main.lua
└── /geometry
├── shape.lua
├── transform.lua
└── init.lua <-- 新增的核心入口文件
init.lua (关键部分):
-- geometry/init.lua
-- 1. 创建一个代表整个包的表
local geometry = {}
-- 2. 加载包内部的私有模块
local Shape = require("geometry.shape")
local Transform = require("geometry.transform")
-- 3. 将需要暴露给外部的函数，挂载到 geometry 表上
geometry.create_circle = Shape.new_circle
geometry.move_shape = Transform.move
-- 4. 返回这个整合后的表
return geometry
现在，我们的 main.lua 可以变得更加简洁和高内聚：
-- main.lua
-- 只需要加载 geometry 这一个包！
local geometry = require("geometry")
-- 通过包提供的主接口来使用功能
local my_shape = geometry.create_circle(10)
geometry.move_shape(my_shape, 5, 5)
print("形状位置:", my_shape.x, my_shape.y)
三、包的搜索路径：package.path
当你调用 require("geometry") 时，Lua 怎么知道去哪里找这个文件呢？它使用 package.path 这个变量，其中包含一系列搜索路径模板。
你可以查看它：
print(package.path)
通常会输出类似这样的内容：
./?.lua;/usr/local/share/lua/5.4/?.lua;/usr/local/share/lua/5.4/?/init.lua
其中的 ? 会被你传给 require 的模块名替换。
如果需要，你也可以修改它来添加自定义搜索路径：
package.path = package.path .. ";/my/custom/path/?.lua"
结语
点个赞，关注我获取更多实用 Lua 技术干货！如果觉得有用，记得收藏本文！
