Lua 的 require 函数

Lua 的 require 函数是模块加载系统的核心功能,用于动态加载和执行 Lua 模块。它的工作机制和特点如下:

  1. 基本功能
  • require 首先会在 package.loaded 表中检查模块是否已加载
  • 如果未加载,则会依次在 package.path(用于.lua文件)和package.cpath(用于C库)指定的路径中搜索模块
  • 找到模块后会执行模块代码,并将返回值存储在 package.loaded 表中
  1. 搜索路径
  • package.path 默认包含以下路径:
    • 当前目录(./?.lua)
    • Lua库目录(/usr/local/share/lua/5.3/?.lua)
    • 用户目录(~/.luarocks/share/lua/5.3/?.lua)
  • 路径中的问号会被替换为模块名
  • 可以通过修改 package.path 来添加自定义搜索路径
  1. 缓存机制
  1. 典型用法示例
lua 复制代码
-- 加载标准库模块
local math = require("math")

-- 加载自定义模块
local mymodule = require("mymodule")

-- 加载子模块
local utils = require("mylib.utils")
  1. 高级特性
  • 可以自定义 package.searchers 表来扩展模块搜索逻辑
  • 支持加载二进制扩展模块(.so/.dll文件)
  • 模块可以返回一个表或函数作为接口
  1. 注意事项
  • 模块名中的点会被转换为路径分隔符(如 "a.b" 会查找 a/b.lua)
  • 循环依赖需要特殊处理
  • 在沙盒环境中可能需要限制 require 的功能

require 的这种设计使得 Lua 的模块系统既灵活又高效,是 Lua 生态的重要组成部分。

相关推荐
程序员黑豆3 小时前
Java 注释详解:单行、多行与文档注释的完整指南
java·前端·ai编程
wuyk5555 小时前
第2章:六步换相原理全解+STM32工程实战
c语言·开发语言·stm32·单片机·嵌入式硬件
hey_sml5 小时前
JAVA每日一学---CompletableFuture中thenApply与thenCompose区别详解
java·开发语言
Doraemomo5 小时前
数据结构-环形链表
java·数据结构·链表
维克兜率天6 小时前
【维克】ARMA模型:AR与MA的完美结合
后端·restful
萧瑟余晖6 小时前
Java深入解析篇十七之SpringCloud
java·开发语言
是未才7 小时前
从输入 URL 到页面返回:DNS、路由、TLS 与 HTTP 完整链路
java·后端·计算机网络
上海安当技术7 小时前
半天接入:USBKey RESTful API + C 动态库,Web 和 C/S 两套集成路径实战
前端·后端·restful·集成·usbkey
ttod_qzstudio7 小时前
Java 常用语法极简通关(五):类与对象——字段、方法、构造器、this 与 static
java·开发语言·python
DevUI团队7 小时前
从“即兴创作”到“规格先行”,华为云码道(CodeArts)代码智能体持续深耕企业级规范驱动开发能力
前端·人工智能·后端