如何在 python中调用 lua

原创已于 2025-12-04 17:07:03 修改 · 468 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#python #lua

于 2025-12-04 16:59:12 首次发布

在Python中调用Lua有多种方法，可以根据需求选择不同的库。为方便你快速选择，这里将常用方案的关键信息进行了整理：

方案对比

· 使用 Lupa (推荐)
· 库/方法: Lupa
· 安装: pip install lupa
· 优点: 性能优异，集成LuaJIT，API简洁，双向交互方便。
· 缺点: 高级Lua库支持可能受限。
· 使用 python-lua
· 库/方法: python-lua 或 python3-lua
· 安装: 系统包管理器 (如 apt) 或从源码编译。
· 优点: 较原始。
· 缺点: 安装稍复杂，非纯Python库。
· 使用 lua-py
· 库/方法: lua-py
· 安装: pip install lua-py
· 优点: 通过pip安装简单。
· 缺点: 搜索结果中信息较少，需验证。
· 底层集成 (适合高级用户)
· 库/方法: ctypes / C API
· 安装: 需Lua开发库。
· 优点: 完全控制，无额外依赖。
· 缺点: 实现复杂，需熟悉C API。

🚀 首选方案：使用 Lupa

对于大多数用户，Lupa 是最佳选择。它性能好，使用简单。

安装
确保已安装Python和pip，然后运行：

pip install lupa

基础使用示例

from lupa import LuaRuntime

# 创建Lua运行时环境
lua = LuaRuntime(unpack_returned_tuples=True)

# 执行一段Lua代码字符串
lua_code = """
function add(a, b)
    return a + b
end
"""
lua.execute(lua_code)  # 执行脚本，定义函数[citation:9]

# 调用Lua中定义的函数
result = lua.globals().add(3, 5)  # 通过globals()获取函数[citation:9]
print(result)  # 输出: 8

# 另一种调用方式：将Lua函数“提取”为Python可调用对象
add_func = lua.eval('function(a, b) return a + b end')
print(add_func(10, 20))  # 输出: 30

进阶交互：传递数据
Lupa支持在两种语言间传递复杂数据。

from lupa import LuaRuntime
lua = LuaRuntime()

# Python列表/字典传递给Lua
python_list = [1, 2, 3]
python_dict = {'name': 'Lua', 'type': 'language'}

# 在Lua代码中使用Python对象
lua_code = """
function process(data_list, data_dict)
    local sum = 0
    for i, v in ipairs(data_list) do
        sum = sum + v
    end
    return sum, data_dict['name']
end
"""
lua.execute(lua_code)
process_func = lua.globals().process

# 调用函数，传递Python对象
lua_sum, lua_name = process_func(python_list, python_dict)
print(f"列表求和: {lua_sum}, 字典名称: {lua_name}")
# 输出: 列表求和: 6, 字典名称: Lua

📦 其他方案简介

你可以根据具体场景选择其他方案：

方案二：使用 python-lua
这是一个较原始的Python-Lua绑定库。在Debian/Ubuntu上可用系统包管理器安装：

sudo apt-get install python3-lua

使用方式与 Lupa 类似，但接口略有不同。

方案三：使用 lua-py
根据搜索结果，你也可以通过pip install lua-py 安装另一个名为 lua-py 的库。其基础用法与 Lupa 非常相似。

方案四：底层集成 (通过C API)
如果你需要深度控制或研究底层原理，可以使用ctypes 直接调用Lua的C语言库。这种方法最灵活，但实现也最复杂，需要自行处理内存、状态管理等。

💡 核心建议与注意事项

· 推荐使用 Lupa：它的社区活跃、文档相对完善、性能好（基于LuaJIT），是当前最主流和稳妥的选择。
· 注意数据类型差异：Lua的数组（表）索引默认从1开始，而Python列表索引从0开始。在相互传递列表/数组数据时要特别注意这一点。
· 安全考虑：在嵌入Lua时，如果运行来自不可信源的脚本，请注意Lua默认可能具有访问文件系统等能力。一些库（如python-lua）默认会禁用这些不安全特性，以增强安全性。
· 验证库的可用性：由于Python第三方库生态变化较快，在尝试 lua-py 等库时，如果遇到安装或导入问题，可以优先考虑换用 Lupa。

🔧 如何开始你的项目？

明确需求：确认你需要在Python中调用Lua的具体场景（例如，复用现有Lua逻辑、需要Lua的轻量快速特性等）。
安装Lupa：在虚拟环境中执行 pip install lupa。
编写测试：参考上面的基础示例，创建一个简单的Python脚本，尝试执行一段Lua代码并获取结果。
集成代码：将成功的测试代码整合到你的主项目中。

以后会分享更多关于如何使用Python调用Lua的具体场景（例如，是希望嵌入游戏逻辑、配置文件，还是进行科学计算？）。