在Lua中使用模块的基础教程实用指南

作者：袖梨 2026-09-03

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“在Lua中采用模块的基础教程”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

什么是模块？

结合项目来看，模块是一个像，能够采用需加载同时有包含表中的单个全局命名的库。该模块可包含若干函数和变量。所有这些函数和变量被包裹在以它作为一个命名空间的表。也是一个很乖的模块有必要的规定，得到此表上所需的。
Lua模块

从实现思路看，表中的模块的采用能够帮助我们以多种方式，使我们能够操纵模块中我们操纵任何其他lua的表相同的方式。作为操纵模块的能力的结果，它提供了额外的功能的量等语言需特殊的机制。由于lua模块，这个免费的方式下，用户能够调用Lua函数以多种方式。如下面几个：

复制代码 代码如下所示:
-- Assuming we have a module printFormatter
-- Also printFormatter has a funtion simpleFormat(arg)
-- Method 1
require "printFormatter"
printFormatter.simpleFormat("test")

-- Method 2
local formatter = require "printFormatter"
formatter.simpleFormat("test")

-- Method 3
require "printFormatter"
local formatterFunction = printFormatter.simpleFormat
formatterFunction("test")

从实现思路看，在上面的示例里，能够看到如何灵活的编程Lua是没有任何特殊的额外的代码。
函数规定

从实现思路看，Lua提供了一个名为规定加载所有必要的模块高级函数。它被保持尽可能的轻松，以避免对模块太多的信息，以将其加载。该规定函数只是假定模块作为一个代码块定义一些值，这实际上是函数或者包含函数表。
示例

从实现思路看，让我们考虑一个轻松的例子，其中一个函数具有数学运算功能，同时允许调用此模块作为mymath和文件名是mymath.lua。该文件的内容如下所示。

复制代码 代码如下所示:
local mymath = {}
function mymath.add(a,b)
print(a+b)
end

function mymath.sub(a,b)
print(a-b)
end

function mymath.mul(a,b)
print(a*b)
end

function mymath.div(a,b)
print(a/b)
end

return mymath

实际处理时，现在为了访问该lua模块中的另一个文件moduletutorial.lua，则如下所示所示。

复制代码 代码如下所示:
mymathmodule = require("mymath")
mymathmodule.add(10,20)
mymathmodule.sub(30,20)
mymathmodule.mul(10,20)
mymathmodule.div(30,20)

实际处理时，为便于运行这些代码，我们需把在同一个目录下2 个lua文件，或者也能够放在包路径的模块文件，同时需产生额外的设置。当我们运行上面的程序，会得到下面的输出。

复制代码 代码如下所示:
30
10
200
1.5

需记住的事情

  • 将模块在同一个目录下运行该文件。
  • 模块名称和它的文件名必须是相同的。
  • 从实现思路看，这是得到模块规定函数，因此该模块也能够完成较好如上图所示，就算能找到其他类型的实现别的地方的最佳实践。

实现模块的老办法

结合项目来看，现在重新编写相同的例子，其中采用包旧的方式。查看所有类型的实现。这是在采用Lua版本5.1和5.0。math模块如下所示所示。

复制代码 代码如下所示:
module("mymath", package.seeall)

function mymath.add(a,b)
print(a+b)
end

function mymath.sub(a,b)
print(a-b)
end

function mymath.mul(a,b)
print(a*b)
end

function mymath.div(a,b)
print(a/b)
end

moduletutorial.lua模块的采用情况如下所示所示。

复制代码 代码如下所示:
require("mymath")
mymath.add(10,20)
mymath.sub(30,20)
mymath.mul(10,20)
mymath.div(30,20)

理解这一步时，当我们运行上面，我们会得到相同的输出。但建议在采用代码的旧版本，它被认为不太安全。采用Lua中像Corona SDK 编程的许多软件开发工具包已经过时。

您可能感兴趣的文章:
  • Lua教程（十一）：模块与包详解
  • Lua模块与包学习笔记
  • Lua中的模块(module)和包(package)详解
  • Lua的函数环境、包实例讲解
  • Lua调用自定义C模块
  • Lua中采用模块的一些基础知识
  • 采用Lua编写Nginx服务器的认证模块的方法
  • Lua极简入门指南（六）：模块
  • Lua模块和模块载入浅析
  • Lua中的模块与module函数详解
  • 解析Lua中的全局环境、包、模块组织结构

相关文章

精彩推荐